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

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

Имя	Описание
UriBuilder()	Инициализирует новый экземпляр класса UriBuilder.
UriBuilder(String)	Инициализирует новый экземпляр UriBuilder класса с указанным универсальным кодом ресурса (URI).
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
Хост	"loopback"
Пароль	Empty
Путь	"/"
Порт	-1
Запрос	Empty
Scheme	"http"
Имя пользователя	Empty

UriBuilder(String)

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

UriBuilder.cs

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

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, который не использует схему file.

–или–

uri недопустимый универсальный код ресурса (URI).

Комментарии

Этот конструктор инициализирует новый экземпляр UriBuilder класса с набором Fragmentсвойств , Hostкак PathPortSchemeQueryуказано в .uriUri

Если 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как PathPortSchemeQueryуказано в .uriUri

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

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

Примеры

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

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

portNumber

Int32

Номер IP-порта для службы.

Исключения

ArgumentOutOfRangeException

portNumber меньше -1 или больше 65 535.

Примеры

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

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

port

Int32

Номер IP-порта для службы.

pathValue

String

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

Исключения

ArgumentOutOfRangeException

port меньше -1 или больше 65 535.

Примеры

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

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

port

Int32

Номер IP-порта для службы.

path

String

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

extraValue

String

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

Исключения

ArgumentException

extraValue не является nullEmptyни допустимым идентификатором фрагмента , ни допустимым идентификатором фрагмента начинается с знака номера (#), ни допустимая строка запроса начинается с вопросительного знака (?).

ArgumentOutOfRangeException

port меньше -1 или больше 65 535.

Примеры

В следующем примере создается экземпляр, содержащий универсальный UriBuilder код ресурса (URI).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свойствомHosthostName, равным, PortportNumber свойству, заданному для свойства, и свойствуPath, заданному в pathValueзначение . Если extraValue начинается числовой знак (#), Fragment то задается значение extraValue. Если extraValue начинается с вопросительного знака (?), Query то устанавливается значение extraValue.

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