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

Определение

Инициализирует новый экземпляр класса 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.cs
Исходный код:
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.cs
Исходный код:
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.

Исключения

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

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

-или-

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

-или-

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

-или-

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

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

Комментарии

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

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

Применяется к

UriBuilder(Uri)

Исходный код:
UriBuilder.cs
Исходный код:
UriBuilder.cs
Исходный код:
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.

Исключения

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

Комментарии

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

Применяется к

UriBuilder(String, String)

Исходный код:
UriBuilder.cs
Исходный код:
UriBuilder.cs
Исходный код:
UriBuilder.cs

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

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)

Параметры

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.cs
Исходный код:
UriBuilder.cs

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

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)

Параметры

scheme
String

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

host
String

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

portNumber
Int32

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

Исключения

Параметр 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.cs
Исходный код:
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);
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

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

Исключения

Параметр 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.cs
Исходный код:
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);
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

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

Исключения

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

Параметр 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, это означает, что для подключения к узлу будет использоваться значение порта по умолчанию для схемы.

Применяется к