Uri.GetComponents(UriComponents, UriFormat) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de opgegeven onderdelen van het huidige exemplaar op met behulp van de opgegeven escape voor speciale tekens.
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 StringParameters
- components
- UriComponents
Een bitsgewijze combinatie van de UriComponents waarden die aangeeft welke delen van het huidige exemplaar moeten worden geretourneerd naar de aanroeper.
- format
- UriFormat
Een van de opsommingswaarden waarmee wordt bepaald hoe speciale tekens worden ontsnapt.
Retouren
De onderdelen van het huidige exemplaar.
Uitzonderingen
components is geen combinatie van geldige UriComponents waarden.
De huidige Uri is geen absolute URI. Relatieve URI's kunnen niet worden gebruikt met deze methode.
Opmerkingen
De Queryonderdelen , Fragment, Scheme, UserInfo, en HostPortPath onderdelen bevatten het scheidingsteken niet. U kunt de KeepDelimiter vlag (met behulp van de bitsgewijze OF-operator) combineren met een van deze waarden om de waarde op te halen met het scheidingsteken. Voor alle andere UriComponents waarden en combinaties van waarden worden de scheidingstekens opgenomen in de geretourneerde waarde.
De onderdelen worden geretourneerd in de volgorde waarin ze worden weergegeven in de URI. Als dit bijvoorbeeld Scheme is opgegeven, wordt deze eerst weergegeven.
Wanneer ondersteuning voor International Resource Identifier (IRI) en Internationalized Domain Name (IDN) is ingeschakeld, wordt het aantal tekens dat wordt geretourneerd in de String toenamen. Punycodenamen die worden gebruikt ter ondersteuning van IRI bevatten alleen ASCII-tekens en beginnen altijd met het xn--voorvoegsel. Wanneer IRI en IDN zijn ingeschakeld, worden Unicode-surrogaattekens correct verwerkt door de GetComponents methode.
Zie de sectie Opmerkingen voor de Uri klas voor meer informatie over IRI-ondersteuning.
Note
Als de GetComponents methode wordt aangeroepen met format ingesteld op Unescaped , kunt u de retourwaarde niet gebruiken als argument voor een Uri constructor om een equivalent Urite maken.