Uri.GetComponents(UriComponents, UriFormat) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar de angivna komponenterna i den aktuella instansen med den angivna escapeingen för specialtecken.
public:
System::String ^ GetComponents(UriComponents components, UriFormat format);public string GetComponents(UriComponents components, UriFormat format);member this.GetComponents : UriComponents * UriFormat -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParametrar
- components
- UriComponents
En bitvis kombination av de UriComponents värden som anger vilka delar av den aktuella instansen som ska returneras till anroparen.
- format
- UriFormat
Ett av uppräkningsvärdena som styr hur specialtecken är undantagna.
Returer
Komponenterna i den aktuella instansen.
Undantag
components är inte en kombination av giltiga UriComponents värden.
Den aktuella Uri är inte en absolut URI. Relativa URI:er kan inte användas med den här metoden.
Kommentarer
Komponenterna Query, Fragment, Scheme, UserInfo, Hostoch PortPath innehåller inte avgränsare. Du kan kombinera KeepDelimiter flaggan (med operatorn BITWISE OR) med något av dessa värden för att hämta värdet med avgränsaren. För alla andra UriComponents värden och kombinationer av värden inkluderas avgränsarna i det returnerade värdet.
Komponenterna returneras i den ordning som de visas i URI:n. Om Scheme det till exempel anges visas det först.
När stöd för internationell resursidentifierare (IRI) och internationaliserat domännamn (IDN) är aktiverat ökar antalet tecken som returneras.String Punycode-namn som används för att stödja IRI innehåller endast ASCII-tecken och börjar alltid med prefixet xn. När IRI och IDN är aktiverade hanteras Unicode-surrogattecken korrekt av GetComponents metoden.
Mer information om IRI-stöd finns i avsnittet Anmärkningar för Uri klassen.
Anmärkning
GetComponents Om metoden anropas med format inställd på Unescaped kan du inte använda returvärdet som ett argument till en Uri konstruktor för att skapa en motsvarande Uri.