URL コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| URL(String) |
|
| URL(URL, String) |
指定したコンテキスト内で指定された仕様を解析して URL を作成します。 |
| URL(URL, String, URLStreamHandler) |
指定したコンテキスト内で指定されたハンドラーを使用して指定された仕様を解析して、URL を作成します。 |
| URL(String, String, String) |
指定した |
| URL(String, String, Int32, String) |
指定した |
| URL(String, String, Int32, String, URLStreamHandler) |
指定した |
URL(String)
String表現からURL オブジェクトを作成します。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public URL(string? spec);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Net.URL : string -> Java.Net.URL
パラメーター
- spec
- String
URL として解析する String 。
- 属性
例外
specを URL として解析できなかった場合は a0/>。
注釈
String表現からURL オブジェクトを作成します。
このコンストラクターは、最初の引数を持つ 2 つの引数コンストラクターの呼び出し null 相当します。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
URL(URL, String)
指定したコンテキスト内で指定された仕様を解析して URL を作成します。
[Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;)V", "")]
public URL(Java.Net.URL? context, string? spec);
[<Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;)V", "")>]
new Java.Net.URL : Java.Net.URL * string -> Java.Net.URL
パラメーター
- context
- URL
仕様を解析するコンテキスト。
- spec
- String
URL として解析する String 。
- 属性
例外
specを URL として解析できなかったか、サポートされていないプロトコルを持っている場合は 2a0/>。
注釈
指定したコンテキスト内で指定された仕様を解析して URL を作成します。
新しい URL は、RFC2396 > で説明されているように、指定されたコンテキスト URL と spec 引数から作成されます。Uniform Resource Identifiers : Generic * Syntax>: <blockquote>
<scheme>://<authority><path>?<query>#<fragment>
</blockquote> 参照はスキーム、機関、パス、クエリ、フラグメント部分に解析されます。 パス コンポーネントが空で、スキーム、権限、およびクエリ コンポーネントが定義されていない場合、新しい URL は現在のドキュメントへの参照になります。 それ以外の場合は、仕様に存在するフラグメント部分とクエリ パーツが新しい URL で使用されます。
スキーム コンポーネントが指定された仕様で定義され、コンテキストのスキームと一致しない場合、新しい URL は、仕様に基づく絶対 URL として作成されます。 それ以外の場合、スキーム コンポーネントはコンテキスト URL から継承されます。
権限コンポーネントがスペック内に存在する場合、スペックは絶対として扱われ、spec 機関とパスはコンテキスト権限とパスを置き換えます。 仕様に権限コンポーネントがない場合、新しい URL の権限はコンテキストから継承されます。
スペックのパス コンポーネントがスラッシュ文字 >/> で始まる場合。その後、パスは絶対パスとして扱われ、spec パスはコンテキスト パスを置き換えます。
それ以外の場合、パスは相対パスとして扱われ、RFC2396で説明されているようにコンテキスト パスに追加されます。 また、この場合、パスは、> の出現によって行われたディレクトリ変更の削除によって正規化されます。>および "。>。
URL 解析の詳細については、RFC2396を参照してください。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
URL(URL, String, URLStreamHandler)
指定したコンテキスト内で指定されたハンドラーを使用して指定された仕様を解析して、URL を作成します。
[Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;Ljava/net/URLStreamHandler;)V", "")]
public URL(Java.Net.URL? context, string? spec, Java.Net.URLStreamHandler? handler);
[<Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;Ljava/net/URLStreamHandler;)V", "")>]
new Java.Net.URL : Java.Net.URL * string * Java.Net.URLStreamHandler -> Java.Net.URL
パラメーター
- context
- URL
仕様を解析するコンテキスト。
- spec
- String
URL として解析する String 。
- handler
- URLStreamHandler
URL のストリーム ハンドラー。
- 属性
例外
指定された文字列 spec を URL として解析できなかったか、無効なプロトコルが見つかった場合。
注釈
指定したコンテキスト内で指定されたハンドラーを使用して指定された仕様を解析して、URL を作成します。 ハンドラーが null の場合、解析は 2 つの引数コンストラクターと同様に行われます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
URL(String, String, String)
指定した protocol 名、 host 名、および file 名から URL を作成します。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V", "")]
public URL(string? protocol, string? host, string? file);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V", "")>]
new Java.Net.URL : string * string * string -> Java.Net.URL
パラメーター
- protocol
- String
使用するプロトコルの名前。
- host
- String
ホストの名前。
- file
- String
ホスト上のファイル。
- 属性
例外
すべての引数の組み合わせが有効な URL を表していない場合、またはプロトコルが無効な場合。
注釈
指定した protocol 名、 host 名、および file 名から URL を作成します。 指定したプロトコルの既定のポートが使用されます。
このメソッドは、引数が protocol、 host、 -1、および fileされている 4 つの引数コンストラクターを呼び出すことと同じです。
このコンストラクターでは、入力の検証は実行されません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
URL(String, String, Int32, String)
指定したprotocol、host、port番号、およびfileからURL オブジェクトを作成します。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;)V", "")]
public URL(string? protocol, string? host, int port, string? file);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;)V", "")>]
new Java.Net.URL : string * string * int * string -> Java.Net.URL
パラメーター
- protocol
- String
使用するプロトコルの名前。
- host
- String
ホストの名前。
- port
- Int32
ホスト上のポート番号。
- file
- String
ホスト上のファイル
- 属性
例外
すべての引数の組み合わせが有効な URL を表していない場合、またはプロトコルが無効な場合。
注釈
指定したprotocol、host、port番号、およびfileからURL オブジェクトを作成します。
host は、ホスト名またはリテラル IP アドレスとして表すことができます。 IPv6 リテラル アドレスを使用する場合は、RFC 2732 で指定されているように、角かっこ ('['と']') で囲む必要があります。ただし、RFC で定義されているリテラル IPv6 アドレス形式。2373: IP バージョン 6 アドレス指定アーキテクチャhttp://www.ietf.org/rfc/rfc2373.txtも受け入れられます。
port数の-1を指定すると、URL がプロトコルの既定のポートを使用する必要があることを示します。
これが指定されたプロトコルで作成される最初の URL オブジェクトである場合は、ストリーム プロトコル ハンドラー オブジェクト (クラス URLStreamHandlerのインスタンス) がそのプロトコルに対して作成されます。 <ol><li>アプリケーションがストリーム ハンドラー ファクトリとして URLStreamHandlerFactory のインスタンスを以前に設定している場合は、そのインスタンスの createURLStreamHandler メソッドがプロトコル文字列を引数として呼び出してストリーム プロトコル ハンドラーを作成します。
<li>まだ URLStreamHandlerFactory が設定されていない場合、またはファクトリの createURLStreamHandler メソッドが nullを返す場合、コンストラクターはシステム プロパティの値 ( <blockquote) を検索します。>
java.protocol.handler.pkgs
</blockquote> そのシステム プロパティの値が nullされていない場合は、垂直方向のスラッシュ文字 '|' で区切られたパッケージの一覧として解釈されます。 コンストラクターは、 <blockquote という名前のクラスを読み込もうとします。>
<<i>package</i>>.<<i>protocol</i>>.Handler
URLStreamHandlerのサブクラスでない場合は、リスト内の次のパッケージが試されます。
<li>前の手順でプロトコル ハンドラーが見つからない場合、コンストラクターはシステムの既定のパッケージから読み込もうとします。
<blockquote>
<<i>system default package</i>>.<<i>protocol</i>>.Handler
</blockquote> このクラスが存在しない場合、またはクラスが存在するが URLStreamHandlerのサブクラスでない場合は、 MalformedURLException がスローされます。
</ol>
次のプロトコルのプロトコル ハンドラーは、検索パスに存在することが保証されます:- <blockquote>
http, https, file, and jar
</blockquote> 追加のプロトコルのプロトコル ハンドラーも使用できます。
このコンストラクターでは、入力の検証は実行されません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
URL(String, String, Int32, String, URLStreamHandler)
指定したprotocol、host、port番号、file、およびhandlerからURL オブジェクトを作成します。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/net/URLStreamHandler;)V", "")]
public URL(string? protocol, string? host, int port, string? file, Java.Net.URLStreamHandler? handler);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/net/URLStreamHandler;)V", "")>]
new Java.Net.URL : string * string * int * string * Java.Net.URLStreamHandler -> Java.Net.URL
パラメーター
- protocol
- String
使用するプロトコルの名前。
- host
- String
ホストの名前。
- port
- Int32
ホスト上のポート番号。
- file
- String
ホスト上のファイル
- handler
- URLStreamHandler
URL のストリーム ハンドラー。
- 属性
例外
すべての引数の組み合わせが有効な URL を表していない場合、またはプロトコルが無効な場合。
注釈
指定したprotocol、host、port番号、file、およびhandlerからURL オブジェクトを作成します。
port数の-1を指定すると、URL がプロトコルの既定のポートを使用する必要があることを示します。
nullのhandlerを指定すると、url はプロトコルの既定のストリーム ハンドラーを使用する必要があることを示します。次に示すように、java.net.URL#URL(java.lang.String, java.lang.String, int, java.lang.String)
ハンドラーが null ではなく、セキュリティ マネージャーがある場合は、セキュリティ マネージャーの checkPermission メソッドが NetPermission("specifyStreamHandler") のアクセス許可を使用して呼び出されます。 これにより、SecurityException が発生する可能性があります。
このコンストラクターでは、入力の検証は実行されません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。