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

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, Port Path, , 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

ArgumentNullException

uri ist null

Hinweise

Dieser Konstruktor initialisiert eine neue Instanz der UriBuilder -Klasse mit den FragmentEigenschaften , Host, Port Path, , 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

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.

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

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

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.

Gilt für:

Freigeben über

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:

Zusätzliche Ressourcen