UriBuilder Konstruktory

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Inicjuje nowe wystąpienie klasy UriBuilder.

Przeciążenia

UriBuilder()	Inicjuje nowe wystąpienie klasy UriBuilder.
UriBuilder(String)	Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego identyfikatora URI.
UriBuilder(Uri)	Inicjuje UriBuilder nowe wystąpienie klasy z określonym Uri wystąpieniem.
UriBuilder(String, String)	Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu i hosta.
UriBuilder(String, String, Int32)	Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu, hosta i portu.
UriBuilder(String, String, Int32, String)	Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu, hosta, numeru portu i ścieżki.
UriBuilder(String, String, Int32, String, String)	Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu, hosta, numeru portu, ścieżki i ciągu zapytania lub identyfikatora fragmentu.

UriBuilder()

Źródło:

UriBuilder.cs

Inicjuje nowe wystąpienie klasy UriBuilder.

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

Uwagi

Konstruktor bez parametrów UriBuilder tworzy nowe wystąpienie klasy z jej właściwościami zainicjowanymi w następujący sposób.

Właściwość	Wartość początkowa
Fragment	Empty
Host	"sprzężenia zwrotnego"
Hasło	Empty
Ścieżka	"/"
Port	-1
Zapytanie	Empty
Schemat	"http"
Nazwa użytkownika	Empty

UriBuilder(String)

Źródło:

UriBuilder.cs

Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego identyfikatora URI.

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

public UriBuilder (string uri);

new UriBuilder : string -> UriBuilder

Public Sub New (uri As String)

Parametry

uri

String

Ciąg identyfikatora URI.

Wyjątki

ArgumentNullException

uri to null.

UriFormatException

uri jest ciągiem o zerowej długości lub zawiera tylko spacje.

-lub-

Procedura analizowania wykryła schemat w nieprawidłowej formie.

-lub-

Analizator wykrył więcej niż dwa kolejne ukośniki w identyfikatorze URI, który nie używa schematu "plik".

-lub-

uri nie jest prawidłowym identyfikatorem URI.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub biblioteki klas przenośnych przechwyć wyjątek klasy bazowej , FormatExceptionzamiast tego.

Uwagi

Ten konstruktor inicjuje UriBuilder nowe wystąpienie klasy z właściwościami Fragment, , HostQueryPortSchemePathi Uri określonymi w parametrze .uri

Jeśli uri nie określi schematu, schemat domyślnie ma wartość "http:".

UriBuilder(Uri)

Źródło:

UriBuilder.cs

Inicjuje UriBuilder nowe wystąpienie klasy z określonym Uri wystąpieniem.

public:
 UriBuilder(Uri ^ uri);

public UriBuilder (Uri uri);

new UriBuilder : Uri -> UriBuilder

Public Sub New (uri As Uri)

Parametry

uri

Uri

Wystąpienie klasy Uri.

Wyjątki

ArgumentNullException

uri to null.

Uwagi

Ten konstruktor inicjuje UriBuilder nowe wystąpienie klasy z właściwościami Fragment, , HostQueryPortSchemePathi Uri określonymi w parametrze .uri

UriBuilder(String, String)

Źródło:

UriBuilder.cs

Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu i hosta.

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)

Parametry

schemeName

String

Protokół dostępu do Internetu.

hostName

String

Nazwa domeny typu DNS lub adres IP.

Przykłady

Poniższy przykład tworzy UriBuilder wystąpienie zawierające identyfikator URI http://www.contoso.com/.

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

Uwagi

Wystąpienie UriBuilder jest inicjowane z właściwością ustawioną Scheme na schemeName , a właściwość ustawiona Host na hostName. Port parametr jest inicjowany do wartości -1, aby wskazać, że należy użyć portu domyślnego schematu, a Path właściwość jest ustawiona na znak ukośnika (/).

UriBuilder(String, String, Int32)

Źródło:

UriBuilder.cs

Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu, hosta i portu.

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)

Parametry

scheme

String

Protokół dostępu do Internetu.

host

String

Nazwa domeny typu DNS lub adres IP.

portNumber

Int32

Numer portu IP dla usługi.

Wyjątki

ArgumentOutOfRangeException

portNumber wartość jest mniejsza niż -1 lub większa niż 65 535.

Przykłady

Poniższy przykład tworzy UriBuilder wystąpienie zawierające identyfikator URI http://www.contoso.com:8080/.

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)

Uwagi

Wystąpienie UriBuilder jest inicjowane za pomocą właściwości ustawionej Scheme na schemeName, Host właściwość ustawiona na hostName, a właściwość ustawiona Port na portNumberwartość . Właściwość Path jest ustawiona na znak ukośnika (/).

portNumber Jeśli parametr jest ustawiony na wartość -1, oznacza to, że domyślna wartość portu dla schematu zostanie użyta do nawiązania połączenia z hostem.

UriBuilder(String, String, Int32, String)

Źródło:

UriBuilder.cs

Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu, hosta, numeru portu i ścieżki.

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)

Parametry

scheme

String

Protokół dostępu do Internetu.

host

String

Nazwa domeny typu DNS lub adres IP.

port

Int32

Numer portu IP dla usługi.

pathValue

String

Ścieżka do zasobu internetowego.

Wyjątki

ArgumentOutOfRangeException

port wartość jest mniejsza niż -1 lub większa niż 65 535.

Przykłady

Poniższy przykład tworzy UriBuilder wystąpienie zawierające identyfikator URI http://www.contoso.com:8080/index.htm.

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

Uwagi

Wystąpienie UriBuilder jest inicjowane za pomocą właściwości ustawionej Scheme na schemeName, Host właściwość ustawiona na hostName, Port właściwość ustawiona na portNumber, a właściwość ustawiona Path na pathValuewartość .

portNumber Jeśli parametr jest ustawiony na wartość -1, oznacza to, że domyślna wartość portu dla schematu zostanie użyta do nawiązania połączenia z hostem.

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

Źródło:

UriBuilder.cs

Inicjuje UriBuilder nowe wystąpienie klasy przy użyciu określonego schematu, hosta, numeru portu, ścieżki i ciągu zapytania lub identyfikatora fragmentu.

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)

Parametry

scheme

String

Protokół dostępu do Internetu.

host

String

Nazwa domeny typu DNS lub adres IP.

port

Int32

Numer portu IP dla usługi.

path

String

Ścieżka do zasobu internetowego.

extraValue

String

Ciąg zapytania lub identyfikator fragmentu.

Wyjątki

ArgumentException

extraValue nie jest ani nullEmpty, ani prawidłowy identyfikator fragmentu rozpoczyna się od znaku liczbowego (#), ani prawidłowego ciągu zapytania rozpoczyna się od znaku zapytania (?).

ArgumentOutOfRangeException

port wartość jest mniejsza niż -1 lub większa niż 65 535.

Przykłady

Poniższy przykład tworzy UriBuilder wystąpienie zawierające identyfikator URI http://www.contoso.com:8080/index.htm#top.

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

Uwagi

Wystąpienie UriBuilder jest inicjowane za pomocą właściwości ustawionej Scheme na schemeName, Host właściwość ustawiona na hostName, Port właściwość ustawiona na portNumber, a właściwość ustawiona Path na pathValuewartość . Jeśli extraValue rozpoczyna się od znaku liczbowego (#), Fragment parametr jest ustawiony na extraValuewartość . Jeśli extraValue zaczyna się od znaku zapytania (?), Query parametr jest ustawiony na extraValuewartość .

portNumber Jeśli parametr jest ustawiony na wartość -1, oznacza to, że domyślna wartość portu dla schematu zostanie użyta do nawiązania połączenia z hostem.