UriBuilder UriBuilder UriBuilder UriBuilder Constructors

定義

オーバーロード

UriBuilder() UriBuilder() UriBuilder()

UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class.

UriBuilder(String) UriBuilder(String) UriBuilder(String) UriBuilder(String)

指定した URI を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified URI.

UriBuilder(Uri) UriBuilder(Uri) UriBuilder(Uri)

指定された UriBuilder インスタンスを使用して、Uri クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified Uri instance.

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

指定したスキームとホストを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme and host.

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

指定したスキーム、ホスト、およびポートを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

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

指定したスキーム、ホスト、ポート番号、およびパスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.

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

指定したスキーム、ホスト、ポート番号、パス、およびクエリ文字列またはフラグメント識別子を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

UriBuilder() UriBuilder() UriBuilder()

UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class.

public:
 UriBuilder();
public UriBuilder ();
Public Sub New ()

注釈

パラメーターなしのコンストラクターは、次のようUriBuilderに初期化されたプロパティを使用して、クラスの新しいインスタンスを作成します。The parameterless constructor creates a new instance of the UriBuilder class with its properties initialized as follows.

プロパティProperty 初期値Initial Value
FragmentFragment Empty
HostHost バック"loopback"
パスワードPassword Empty
パスPath "/""/"
ポートPort -1-1
クエリQuery Empty
SchemeScheme http"http"
UserNameUserName Empty

UriBuilder(String) UriBuilder(String) UriBuilder(String) UriBuilder(String)

指定した URI を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified URI.

public:
 UriBuilder(System::String ^ uri);
public UriBuilder (string uri);
new UriBuilder : string -> UriBuilder
Public Sub New (uri As String)

パラメーター

uri
String String String String

URI 文字列。A URI string.

例外


Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uri は長さ 0 の文字列、または空白だけを含みます。 uri is a zero length string or contains only spaces.

- または --or- 解析ルーチンが無効な形式のスキームを検出しました。The parsing routine detected a scheme in an invalid form.

または-or- パーサーが、"file" スキームを使用しない URI で 3 つ以上の連続するスラッシュを検出しました。The parser detected more than two consecutive slashes in a URI that does not use the "file" scheme.

- または --or- uri は有効な URI ではありません。uri is not a valid URI.

注釈

このコンストラクターはUriBuilder Fragment Port Host Path Query 、次Uriのように設定された、、、、、、およびの各プロパティを使用して、クラスの新しいインスタンスを初期化します。Scheme uri.This constructor initializes a new instance of the UriBuilder class with the Fragment, Host, Path, Port, Query, Scheme, and Uri properties set as specified in uri.

uriスキームが指定されていない場合、スキームの既定値は "http:" になります。If uri does not specify a scheme, the scheme defaults to "http:".

UriBuilder(Uri) UriBuilder(Uri) UriBuilder(Uri)

指定された UriBuilder インスタンスを使用して、Uri クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified Uri instance.

public:
 UriBuilder(Uri ^ uri);
public UriBuilder (Uri uri);
new UriBuilder : Uri -> UriBuilder

パラメーター

uri
Uri Uri Uri Uri

Uri クラスのインスタンス。An instance of the Uri class.

例外

注釈

このコンストラクターはUriBuilder Fragment Port Host Path Query 、次Uriのように設定された、、、、、、およびの各プロパティを使用して、クラスの新しいインスタンスを初期化します。Scheme uri.This constructor initializes a new instance of the UriBuilder class with the Fragment, Host, Path, Port, Query, Scheme, and Uri properties set as specified in uri.

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

指定したスキームとホストを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme and host.

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 String String String

インターネット アクセス プロトコル。An Internet access protocol.

hostName
String String String String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

次の例ではUriBuilder 、URI http://www.contoso.com/を含むインスタンスを作成します。The following example creates a UriBuilder instance that contains the URI http://www.contoso.com/.

UriBuilder^ myUri = gcnew UriBuilder(  "http", "www.contoso.com" );
UriBuilder myUri = new UriBuilder("http","www.contoso.com");

Dim myUri As New UriBuilder("http", "www.contoso.com")

注釈

Scheme Host hostNameインスタンスは、にschemeName設定されたプロパティと、に設定されたプロパティを使用して初期化されます。 UriBuilderThe UriBuilder instance is initialized with the Scheme property set to schemeName and the Host property set to hostName. Portは、スキームの既定のポートを使用Pathする必要があることを示すために値-1 に初期化され、プロパティはスラッシュ (/) に設定されます。Port is initialized to the value -1 to indicate the default port for the scheme should be used, and the Path property is set to the slash character (/).

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

指定したスキーム、ホスト、およびポートを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

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 String String String

インターネット アクセス プロトコル。An Internet access protocol.

host
String String String String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

portNumber
Int32 Int32 Int32 Int32

このサービスの IP ポート番号。An IP port number for the service.

例外

portNumber が -1 より小さいか、65,535 を超えています。portNumber is less than -1 or greater than 65,535.

次の例ではUriBuilder 、URI http://www.contoso.com:8080/を含むインスタンスを作成します。The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/.

UriBuilder^ myUri = gcnew UriBuilder( "http", "www.contoso.com",8080 );
UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080);

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080)

注釈

Host hostName portNumber Portインスタンスは、にschemeName設定さSchemeれたプロパティ、に設定されたプロパティ、およびに設定されたプロパティを使用して初期化されます。 UriBuilderThe UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, and the Port property set to portNumber. Pathプロパティはスラッシュ (/) に設定されます。The Path property is set to the slash character (/).

の値scheme hostが-1 に設定されている場合は、の既定のポート値がに接続するために使用されることを示します。 portNumberIf the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

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

指定したスキーム、ホスト、ポート番号、およびパスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.

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 String String String

インターネット アクセス プロトコル。An Internet access protocol.

host
String String String String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

port
Int32 Int32 Int32 Int32

このサービスの IP ポート番号。An IP port number for the service.

pathValue
String String String String

インターネット リソースへのパス。The path to the Internet resource.

例外

port が -1 より小さいか、65,535 を超えています。port is less than -1 or greater than 65,535.

次の例ではUriBuilder 、URI http://www.contoso.com:8080/index.htmを含むインスタンスを作成します。The following example creates a UriBuilder instance that contains the 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");

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm")

注釈

hostName Scheme Port Path portNumberインスタンスは、にschemeName設定されたプロパティ、に設定されたプロパティ、に設定されたプロパティ、およびに設定されたプロパティを使用して初期化されます。 Host UriBuilder pathValue.The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber and the Path property set to pathValue.

の値scheme hostが-1 に設定されている場合は、の既定のポート値がに接続するために使用されることを示します。 portNumberIf the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

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

指定したスキーム、ホスト、ポート番号、パス、およびクエリ文字列またはフラグメント識別子を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

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 String String String

インターネット アクセス プロトコル。An Internet access protocol.

host
String String String String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

port
Int32 Int32 Int32 Int32

このサービスの IP ポート番号。An IP port number for the service.

path
String String String String

インターネット リソースへのパス。The path to the Internet resource.

extraValue
String String String String

クエリ文字列またはフラグメント識別子。A query string or fragment identifier.

例外

extraValue が、nullEmpty、シャープ記号 (#) で始まる有効なフラグメント識別子、疑問符 (?) で始まる有効なクエリ文字列のいずれでもありません。extraValue is neither null nor Empty, nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?).

port が -1 より小さいか、65,535 を超えています。port is less than -1 or greater than 65,535.

次の例ではUriBuilder 、URI http://www.contoso.com:8080/index.htm#topを含むインスタンスを作成します。The following example creates a UriBuilder instance that contains the 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");

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm", "#top")

注釈

hostName Scheme Port Path portNumberインスタンスは、にschemeName設定されたプロパティ、に設定されたプロパティ、に設定されたプロパティ、およびプロパティがに設定された状態で初期化されます。 Host UriBuilderpathValue.The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber, and the Path property is set to pathValue. がシャープ記号 (#) で始まる場合extraValue extraValue、はに設定されます。 FragmentIf extraValue begins with a number sign (#), then Fragment is set to extraValue. が疑問符 (?) で始まる場合extraValue extraValue、はに設定されます。 QueryIf extraValue begins with a question mark (?), then Query is set to extraValue.

の値scheme hostが-1 に設定されている場合は、の既定のポート値がに接続するために使用されることを示します。 portNumberIf the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

適用対象