Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
URL 文字列を正規フォームに変換します。
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。
public:
static System::String ^ CanonizeURL(System::String ^ pURL, Microsoft::IE::Manager::URL_CANONFLAGS flags);
public static string CanonizeURL (string pURL, Microsoft.IE.Manager.URL_CANONFLAGS flags);
static member CanonizeURL : string * Microsoft.IE.Manager.URL_CANONFLAGS -> string
Public Shared Function CanonizeURL (pURL As String, flags As Manager.URL_CANONFLAGS) As String
パラメーター
- pURL
- String
URL 文字列を含み、NULL で終わる文字列。最大長が INTERNET_MAX_URL_LENGTH。 文字列がファイルを参照しない場合、"http://" のような有効なスキームが含まれている必要があります。
- flags
- Manager.URL_CANONFLAGS
URL を正規フォームに変換する方法を指定するフラグ。 次のフラグを組み合わせることができます。
Manager.URL_CANONFLAGS: URL 文字列内の "/./" と "/../" を、ナビゲーションのための短縮形としてではなく、リテラル文字列として処理します。
Manager.URL_CANONFLAGS: "%" が現れた場合、それをそのエスケープ シーケンスに変換します。
Manager.URL_CANONFLAGS: スペースだけをエスケープ シーケンスで置換します。 このフラグは Manager.URL_CANONFLAGS より優先されますが、あいまいな URL には適用されません。
Manager.URL_CANONFLAGS: 安全でない文字をそのエスケープ シーケンスに置換します。 安全でない文字とは、インターネット経由で転送されるとき、改ざんされるおそれがある文字のことです。 これには、 <、、 >"、#、{、}、|、\、^、[、]、および ' 文字が含まれます。 このフラグは、あいまいな URL を含む、すべての URL に適用されます。
Manager.URL_CANONFLAGS: Manager.URL_CANONFLAGS と同じになるように定義されます。
Manager.URL_CANONFLAGS: World Wide Web コンソーシアム (W3C) の仕様に基づき、クライアントが定義したプラグ可能プロトコルと URL を結合します。 このフラグは、FTP、HTTP、Gopher など、標準のプロトコルには適用されません。 このフラグが設定されている場合、Manager.URL_CANONFLAGS も設定する必要はありません。
Manager.URL_CANONFLAGS: 2 つの例外を除き、URL に含まれるエスケープ シーケンスのエスケープを解除します。 "?" と "#" のエスケープ シーケンスのエスケープは解除されません。 URL_ESCAPE フラグも設定されている場合、最初に 2 つの URL のエスケープが解除され、それから結合され、それからエスケープされます。
戻り値
正規化された URL。