UriBuilder Konstruktoren

Definition

Namespace:

System

Assembly:

System.Runtime.dll

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 Instanz der -Klasse mit dem UriBuilder angegebenen Schema, Host, Portnummer, Pfad und Abfragezeichenfolge oder Fragmentbezeichner.

UriBuilder()

Quelle:

UriBuilder.cs

Initialisiert eine neue Instanz der UriBuilder-Klasse.

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

Hinweise

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

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

UriBuilder(String)

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: Erfassen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassen-Ausnahme FormatException.

Hinweise

Dieser Konstruktor initialisiert eine neue Instanz der UriBuilder -Klasse mit den FragmentEigenschaften , Host, PortPath, , Query, SchemeundUri, die festgelegt sind, wie in uriangegeben.

Wenn uri kein Schema angegeben wird, wird das Schema standardmäßig auf "http:" festgelegt.

UriBuilder(Uri)

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 Instanz der UriBuilder -Klasse mit den FragmentEigenschaften , Host, PortPath, , Query, SchemeundUri, die festgelegt sind, wie in uriangegeben.

UriBuilder(String, String)

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);

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 Instanz 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 -Instanz 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 das Schrägstrichzeichen (/) festgelegt.

UriBuilder(String, String, Int32)

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);

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 Instanz 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 -Instanz wird initialisiert, wobei die Scheme -Eigenschaft auf schemeNamefestgelegt ist, die Host -Eigenschaft auf hostNamefestgelegt ist und die Port -Eigenschaft auf portNumberfestgelegt ist. Die Path -Eigenschaft ist auf den Schrägstrich (/) festgelegt.

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

UriBuilder(String, String, Int32, String)

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);

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 Instanz 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

Die UriBuilder -Instanz wird initialisiert, wobei die Scheme -Eigenschaft auf schemeNamefestgelegt ist, Host die -Eigenschaft auf hostNamefestgelegt ist, die Port -Eigenschaft auf portNumberfestgelegt ist und die Path -Eigenschaft auf pathValuefestgelegt ist.

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

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

Quelle:

UriBuilder.cs

Initialisiert eine neue Instanz der -Klasse mit dem UriBuilder 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);

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 Instanz 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 -Instanz wird initialisiert, wobei die Scheme -Eigenschaft auf schemeNamefestgelegt ist, Host die -Eigenschaft auf hostNamefestgelegt ist, die Port -Eigenschaft auf portNumberfestgelegt ist und die Path -Eigenschaft auf pathValuefestgelegt ist. Wenn extraValue mit einem Zahlenzeichen (#) beginnt, Fragment wird auf extraValuefestgelegt. Wenn extraValue mit einem Fragezeichen (?) beginnt, ist auf QueryextraValuefestgelegt.

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