Language

Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) メソッド

定義

名前空間:
Microsoft.IE
アセンブリ:
IEHost.dll

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 文字列を含む最大長 (INTERNET_MAX_URL_LENGTH) の null で終わる文字列。 文字列がファイルを参照していない場合は、"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 Consortium (W3C) 仕様に従って、URL をクライアント定義のプラグ可能なプロトコルと結合します。 このフラグは、FTP、HTTP、Gopher などの標準プロトコルには適用されません。 このフラグが設定されている場合は、 Manager.URL_CANONFLAGSも設定する必要はありません。

  • Manager.URL_CANONFLAGS: 2 つの例外を除き、URL に含まれるエスケープ シーケンスをエスケープしません。 "?" と "#" のエスケープ シーケンスはエスケープされません。 URL_ESCAPEフラグの 1 つも設定されている場合、2 つの URL は最初にエスケープ解除され、結合されてからエスケープされます。

返品

String

正規化された URL。

適用対象