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, Path, Port, 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, Path, Port, 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 инициализируется со свойством schemeNameScheme , свойству Host присваивается значение hostName, свойству Port присваивается значение portNumber, а свойству 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 инициализируется со свойством schemeNameScheme , свойству Host присваивается значение hostName, свойству Port присваивается значение portNumber, а свойству Path — значение pathValue. Если extraValue начинается с числового знака (#), то Fragment параметру extraValueприсваивается значение . Если extraValue начинается с вопросительного знака (?), то Query параметру extraValueприсваивается значение .

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