UriBuilder Konstruktoren

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.Extensions.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der UriBuilder-Klasse.

Überlädt

UriBuilder()	Initialisiert eine neue Instanz der UriBuilder-Klasse.
UriBuilder(String)	Initialisiert eine neue Instanz der UriBuilder-Klasse mit dem angegebenen URI.
UriBuilder(Uri)	Initialisiert eine neue Instanz der UriBuilder-Klasse mit der angegebenen Uri-Instanz.
UriBuilder(String, String)	Initialisiert eine neue Instanz der UriBuilder-Klasse mit dem angegebenen Schema und dem angegebenen Host.
UriBuilder(String, String, Int32)	Initialisiert eine neue Instanz der UriBuilder-Klasse mit den Angaben für Schema, Host und Anschluss.
UriBuilder(String, String, Int32, String)	Initialisiert eine neue Instanz der UriBuilder-Klasse mit den Angaben für Schema, Host, Anschluss und Pfad.
UriBuilder(String, String, Int32, String, String)	Initialisiert eine neue instance der UriBuilder -Klasse mit dem angegebenen Schema, Host, Portnummer, Pfad und Abfragezeichenfolge oder Fragmentbezeichner.

UriBuilder()

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse.

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

Hinweise

Der parameterlose Konstruktor erstellt eine neue instance der UriBuilder -Klasse, deren Eigenschaften wie folgt initialisiert sind.

Eigenschaft	Anfangswert
Fragment	Empty
Host	"Loopback"
Kennwort	Empty
`Path`	"/"
Port	-1
Abfrage	Empty
Schema	"http"
UserName	Empty

Gilt für:

UriBuilder(String)

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse mit dem angegebenen URI.

public:
 UriBuilder(System::String ^ uri);

public UriBuilder (string uri);

new UriBuilder : string -> UriBuilder

Public Sub New (uri As String)

Parameter

uri: String

Eine URI-Zeichenfolge.

Ausnahmen

ArgumentNullException

uri ist null.

UriFormatException

uri ist eine Zeichenfolge der Länge 0 (null) oder enthält nur Leerzeichen.

- oder -

Die Analyseroutine hat ein Schema in einem ungültigen Formular erkannt.

- oder -

Der Parser hat mehr als zwei aufeinander folgende Schrägstriche in einem URI erkannt, der nicht das Schema „Datei“ verwendet.

- oder -

uri ist kein gültiger URI.

Hinweis: In .NET für Windows Store-Apps oder der portablen Klassenbibliothek sollten Sie stattdessen die Basisklassen-Ausnahme FormatExceptionabfangen.

Hinweise

Dieser Konstruktor initialisiert eine neue instance der UriBuilder -Klasse, wobei die FragmentEigenschaften , Host, Port Path, Query, Scheme, und Uri festgelegt sind, wie in uriangegeben.

Wenn uri kein Schema angegeben wird, wird standardmäßig "http:" verwendet.

Gilt für:

UriBuilder(Uri)

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse mit der angegebenen Uri-Instanz.

public:
 UriBuilder(Uri ^ uri);

public UriBuilder (Uri uri);

new UriBuilder : Uri -> UriBuilder

Public Sub New (uri As Uri)

Parameter

uri: Uri

Eine Instanz der Uri-Klasse.

Ausnahmen

ArgumentNullException

uri ist null

Hinweise

Dieser Konstruktor initialisiert eine neue instance der UriBuilder -Klasse, wobei die FragmentEigenschaften , Host, Port Path, Query, Scheme, und Uri festgelegt sind, wie in uriangegeben.

Gilt für:

UriBuilder(String, String)

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse mit dem angegebenen Schema und dem angegebenen Host.

public:
 UriBuilder(System::String ^ schemeName, System::String ^ hostName);

public UriBuilder (string schemeName, string hostName);

public UriBuilder (string? schemeName, string? hostName);

new UriBuilder : string * string -> UriBuilder

Public Sub New (schemeName As String, hostName As String)

Parameter

schemeName: String

Ein Internetprotokoll.

hostName: String

Ein Domänenname im DNS-Format oder eine IP-Adresse.

Beispiele

Im folgenden Beispiel wird eine UriBuilder instance erstellt, die den URI http://www.contoso.com/enthält.

UriBuilder^ myUri = gcnew UriBuilder(  "http", "www.contoso.com" );

UriBuilder myUri = new UriBuilder("http","www.contoso.com");

let myUri = UriBuilder "http","www.contoso.com"

Dim myUri As New UriBuilder("http", "www.contoso.com")

Hinweise

Die UriBuilder instance wird initialisiert, wobei die Scheme -Eigenschaft auf schemeName und die Host -Eigenschaft auf hostNamefestgelegt ist. Port wird mit dem Wert -1 initialisiert, um anzugeben, dass der Standardport für das Schema verwendet werden soll, und die Path Eigenschaft wird auf den Schrägstrich (/) festgelegt.

Gilt für:

UriBuilder(String, String, Int32)

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse mit den Angaben für Schema, Host und Anschluss.

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int portNumber);

public UriBuilder (string scheme, string host, int portNumber);

public UriBuilder (string? scheme, string? host, int portNumber);

new UriBuilder : string * string * int -> UriBuilder

Public Sub New (scheme As String, host As String, portNumber As Integer)

Parameter

scheme: String

Ein Internetprotokoll.

host: String

Ein Domänenname im DNS-Format oder eine IP-Adresse.

portNumber: Int32

Eine IP-Anschlussnummer für den Dienst.

Ausnahmen

ArgumentOutOfRangeException

portNumber ist kleiner als –1 oder größer als 65.535.

Beispiele

Im folgenden Beispiel wird eine UriBuilder instance erstellt, die den URI http://www.contoso.com:8080/enthält.

UriBuilder^ myUri = gcnew UriBuilder( "http", "www.contoso.com",8080 );

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080);

let myUri = UriBuilder("http","www.contoso.com", 8080)

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080)

Hinweise

Die UriBuilder instance wird initialisiert, wobei die Scheme -Eigenschaft auf schemeNamefestgelegt ist, die Host -Eigenschaft auf hostNameund die Port -Eigenschaft auf portNumberfestgelegt ist. Die Path -Eigenschaft ist auf den Schrägstrich (/) festgelegt.

Wenn auf portNumber den Wert -1 festgelegt ist, gibt dies an, dass der Standardportwert für das Schema verwendet wird, um eine Verbindung mit dem Host herzustellen.

Gilt für:

UriBuilder(String, String, Int32, String)

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse mit den Angaben für Schema, Host, Anschluss und Pfad.

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int port, System::String ^ pathValue);

public UriBuilder (string scheme, string host, int port, string pathValue);

public UriBuilder (string? scheme, string? host, int port, string? pathValue);

new UriBuilder : string * string * int * string -> UriBuilder

Public Sub New (scheme As String, host As String, port As Integer, pathValue As String)

Parameter

scheme: String

Ein Internetprotokoll.

host: String

Ein Domänenname im DNS-Format oder eine IP-Adresse.

port: Int32

Eine IP-Anschlussnummer für den Dienst.

pathValue: String

Der Pfad zur Internetressource.

Ausnahmen

ArgumentOutOfRangeException

port ist kleiner als –1 oder größer als 65.535.

Beispiele

Im folgenden Beispiel wird eine UriBuilder instance erstellt, die den URI http://www.contoso.com:8080/index.htmenthält.

UriBuilder^ myUri = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm" );

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm");

let myUri = UriBuilder("http","www.contoso.com", 8080, "index.htm")

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm")

Hinweise

Wenn auf portNumber den Wert -1 festgelegt ist, gibt dies an, dass der Standardportwert für das Schema verwendet wird, um eine Verbindung mit dem Host herzustellen.

Gilt für:

UriBuilder(String, String, Int32, String, String)

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Quelle:: UriBuilder.cs

Initialisiert eine neue instance der UriBuilder -Klasse mit dem angegebenen Schema, Host, Portnummer, Pfad und Abfragezeichenfolge oder Fragmentbezeichner.

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int port, System::String ^ path, System::String ^ extraValue);

public UriBuilder (string scheme, string host, int port, string path, string extraValue);

public UriBuilder (string? scheme, string? host, int port, string? path, string? extraValue);

new UriBuilder : string * string * int * string * string -> UriBuilder

Public Sub New (scheme As String, host As String, port As Integer, path As String, extraValue As String)

Parameter

scheme: String

Ein Internetprotokoll.

host: String

Ein Domänenname im DNS-Format oder eine IP-Adresse.

port: Int32

Eine IP-Anschlussnummer für den Dienst.

path: String

Der Pfad zur Internetressource.

extraValue: String

Eine Abfragezeichenfolge oder ein Fragmentbezeichner.

Ausnahmen

ArgumentException

extraValue ist weder null noch Empty, und weder beginnt ein gültiger Fragmentbezeichner mit einem Nummernzeichen (#), noch eine gültige Abfragezeichenfolge mit einem Fragezeichen (?).

ArgumentOutOfRangeException

port ist kleiner als –1 oder größer als 65.535.

Beispiele

Im folgenden Beispiel wird eine UriBuilder instance erstellt, die den URI http://www.contoso.com:8080/index.htm#topenthält.

UriBuilder^ myUri = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm","#top" );

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm","#top");

let myUri = UriBuilder("http","www.contoso.com", 8080, "index.htm", "#top")

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm", "#top")

Hinweise

Die UriBuilder instance wird initialisiert, wobei die Scheme -Eigenschaft auf schemeNamefestgelegt ist, die Host -Eigenschaft auf hostName, die Port -Eigenschaft auf portNumberund die Path -Eigenschaft auf pathValuefestgelegt ist. Wenn extraValue mit einem Nummernzeichen (#) beginnt, Fragment wird auf extraValuefestgelegt. Wenn extraValue mit einem Fragezeichen (?) beginnt, ist auf QueryextraValuefestgelegt.

Wenn auf portNumber den Wert -1 festgelegt ist, gibt dies an, dass der Standardportwert für das Schema verwendet wird, um eine Verbindung mit dem Host herzustellen.

Gilt für:

UriBuilder Konstruktoren

Definition

Überlädt

UriBuilder()

Hinweise

Gilt für:

UriBuilder(String)

Parameter

Ausnahmen

Hinweise

Gilt für:

UriBuilder(Uri)

Parameter

Ausnahmen

Hinweise

Gilt für:

UriBuilder(String, String)

Parameter

Beispiele

Hinweise

Gilt für:

UriBuilder(String, String, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

UriBuilder(String, String, Int32, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

UriBuilder(String, String, Int32, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen