UriBuilder Konstruktoren

Definition

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

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

uri ist null.

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.

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

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.

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

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

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.

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

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.

Gilt für:

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

Quelle:
UriBuilder.cs
Quelle:
UriBuilder.cs
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);
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

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

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.

Gilt für: