UriBuilder Конструкторы

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Инициализирует новый экземпляр класса UriBuilder.

Перегрузки

UriBuilder()	Инициализирует новый экземпляр класса UriBuilder.
UriBuilder(String)	Инициализирует новый экземпляр класса UriBuilder с заданным универсальным кодом ресурса.
UriBuilder(Uri)	Инициализирует новый экземпляр класса UriBuilder с указанным экземпляром Uri.
UriBuilder(String, String)	Инициализирует новый экземпляр класса UriBuilder в соответствии с заданной схемой и узлом.
UriBuilder(String, String, Int32)	Инициализирует новый экземпляр класса UriBuilder в соответствии с заданной схемой, узлом и портом.
UriBuilder(String, String, Int32, String)	Инициализирует новый экземпляр класса UriBuilder в соответствии с заданной схемой, узлом, номером порта и путем.
UriBuilder(String, String, Int32, String, String)	Инициализирует новый экземпляр класса с указанной UriBuilder схемой, узлом, номером порта, путем и идентификатором строки запроса или фрагмента.

UriBuilder()

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса UriBuilder.

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

Комментарии

Конструктор без параметров создает новый экземпляр класса с его свойствами, инициализированными UriBuilder следующим образом.

Свойство	Начальное значение
Fragment	Empty
Узел	"замыкания на себя"
Пароль	Empty
путь	"/"
Port	-1
Запрос	Empty
Схема	"http"
UserName	Empty

UriBuilder(String)

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса UriBuilder с заданным универсальным кодом ресурса.

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

public UriBuilder (string uri);

new UriBuilder : string -> UriBuilder

Public Sub New (uri As String)

Параметры

uri

String

Строка URI.

Исключения

ArgumentNullException

uri имеет значение null.

UriFormatException

uri — это пустая или содержащая только пробелы строка.

-или-

Подпрограмма синтаксического анализа обнаружила схему в недопустимой форме.

-или-

Средство синтаксического анализа обнаружило более двух знаков косой черты подряд в URI, который не использует схему файла.

-или-

uri не является допустимым URI.

Примечание. В .NET для приложений Магазина Windows или переносимой библиотеки классов перехватите исключение базового класса , FormatException.

Комментарии

Этот конструктор инициализирует новый экземпляр UriBuilder класса со свойствами Fragment, Host, , PathPort, Query, Scheme, и Uri , как указано в uri.

Если uri схема не указана, по умолчанию используется "http:".

UriBuilder(Uri)

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса UriBuilder с указанным экземпляром Uri.

public:
 UriBuilder(Uri ^ uri);

public UriBuilder (Uri uri);

new UriBuilder : Uri -> UriBuilder

Public Sub New (uri As Uri)

Параметры

uri

Uri

Экземпляр класса Uri.

Исключения

ArgumentNullException

uri имеет значение null.

Комментарии

Этот конструктор инициализирует новый экземпляр UriBuilder класса со свойствами Fragment, Host, , PathPort, Query, Scheme, и Uri , как указано в uri.

UriBuilder(String, String)

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса UriBuilder в соответствии с заданной схемой и узлом.

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)

Параметры

schemeName

String

Протокол доступа к Интернету.

hostName

String

DNS-имя домена или IP-адрес.

Примеры

В следующем примере создается UriBuilder экземпляр , содержащий универсальный код ресурса (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")

Комментарии

Экземпляр UriBuilder инициализируется свойством Scheme , для свойства задано значение schemeName , а Host для свойства — значение hostName. Port инициализируется значением -1, чтобы указать, что для схемы должен использоваться порт по умолчанию, а Path свойству присваивается символ косой черты (/).

UriBuilder(String, String, Int32)

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса UriBuilder в соответствии с заданной схемой, узлом и портом.

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)

Параметры

scheme

String

Протокол доступа к Интернету.

host

String

DNS-имя домена или IP-адрес.

portNumber

Int32

Номер порта IP, используемый службой.

Исключения

ArgumentOutOfRangeException

Параметр portNumber имеет значение меньше –1 или больше 65 535.

Примеры

В следующем примере создается UriBuilder экземпляр , содержащий универсальный код ресурса (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)

Комментарии

Экземпляр UriBuilder инициализируется свойством schemeNameScheme , свойству Host присваивается значение hostName, а свойству Port — значение portNumber. Свойству Path присваивается символ косой черты (/).

portNumber Если для задано значение -1, это означает, что для подключения к узлу будет использоваться значение порта по умолчанию для схемы.

UriBuilder(String, String, Int32, String)

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса UriBuilder в соответствии с заданной схемой, узлом, номером порта и путем.

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)

Параметры

scheme

String

Протокол доступа к Интернету.

host

String

DNS-имя домена или IP-адрес.

port

Int32

Номер порта IP, используемый службой.

pathValue

String

Путь к Интернет- ресурсу.

Исключения

ArgumentOutOfRangeException

Параметр port имеет значение меньше –1 или больше 65 535.

Примеры

В следующем примере создается UriBuilder экземпляр , содержащий универсальный код ресурса (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")

Комментарии

Экземпляр UriBuilder инициализируется свойством SchemeschemeName, свойству Host присвоено значение hostName, свойству присвоено значение , свойству PortportNumberприсвоено значение , а свойству Path — значение pathValue.

portNumber Если для задано значение -1, это означает, что для подключения к узлу будет использоваться значение порта по умолчанию для схемы.

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

Исходный код:

UriBuilder.cs

Инициализирует новый экземпляр класса с указанной UriBuilder схемой, узлом, номером порта, путем и идентификатором строки запроса или фрагмента.

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)

Параметры

scheme

String

Протокол доступа к Интернету.

host

String

DNS-имя домена или IP-адрес.

port

Int32

Номер порта IP, используемый службой.

path

String

Путь к Интернет- ресурсу.

extraValue

String

Строка запроса или идентификатор фрагмента.

Исключения

ArgumentException

Параметр extraValue не принимает ни значение null, ни значение Empty, не является допустимым идентификатором фрагмента, начинающимся со знака решетки (#) и не является допустимой строкой запроса, начинающейся с вопросительного знака (?).

ArgumentOutOfRangeException

Параметр port имеет значение меньше –1 или больше 65 535.

Примеры

В следующем примере создается UriBuilder экземпляр , содержащий универсальный код ресурса (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")

Комментарии

Экземпляр UriBuilder инициализируется свойством SchemeschemeName, свойству Host присвоено значение hostName, свойству присвоено значение , свойству PortportNumberприсвоено значение , а свойству Path — значение pathValue. Если extraValue начинается с числового знака (#), то Fragment параметру присваивается значение extraValue. Если extraValue начинается с вопросительного знака (?), то Query параметру присваивается значение extraValue.

portNumber Если для задано значение -1, это означает, что для подключения к узлу будет использоваться значение порта по умолчанию для схемы.