Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

UriTemplate-Klasse

 

Veröffentlicht: Oktober 2016

Eine Klasse, die eine URI-Vorlage (Uniform Resource Identifier) darstellt.

Namespace:   System
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

System.Object
  System.UriTemplate

public class UriTemplate

NameBeschreibung
System_CAPS_pubmethodUriTemplate(String)

Initialisiert eine neue Instanz der UriTemplate-Klasse mit der angegebenen Vorlagenzeichenfolge.

System_CAPS_pubmethodUriTemplate(String, Boolean)

Initialisiert eine neue Instanz der UriTemplate-Klasse.

System_CAPS_pubmethodUriTemplate(String, Boolean, IDictionary<String, String>)

Initialisiert eine neue Instanz der UriTemplate-Klasse.

System_CAPS_pubmethodUriTemplate(String, IDictionary<String, String>)

Initialisiert eine neue Instanz der UriTemplate-Klasse.

NameBeschreibung
System_CAPS_pubpropertyDefaults

Ruft eine Auflistung von Name/Wert-Paaren für sämtliche Standardparameterwerte ab.

System_CAPS_pubpropertyIgnoreTrailingSlash

Gibt an, ob nachstehende Schrägstriche "/" in der Vorlage beim Vergleich mit möglichen URIs ignoriert werden sollen.

System_CAPS_pubpropertyPathSegmentVariableNames

Ruft eine Auflistung der Variablennamen ab, die innerhalb der Pfadsegmente in der Vorlage verwendet werden.

System_CAPS_pubpropertyQueryValueVariableNames

Ruft eine Auflistung der Variablennamen ab, die innerhalb der Abfragezeichenfolge in der Vorlage verwendet werden.

NameBeschreibung
System_CAPS_pubmethodBindByName(Uri, IDictionary<String, String>)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

System_CAPS_pubmethodBindByName(Uri, IDictionary<String, String>, Boolean)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

System_CAPS_pubmethodBindByName(Uri, NameValueCollection)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

System_CAPS_pubmethodBindByName(Uri, NameValueCollection, Boolean)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

System_CAPS_pubmethodBindByPosition(Uri, String[])

Erstellt einen neuen URI aus der Vorlage und einem Array von Parameterwerten.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsEquivalentTo(UriTemplate)

Gibt an, ob eine UriTemplate strukturell äquivalent zu einer anderen ist.

System_CAPS_pubmethodMatch(Uri, Uri)

Versucht, einen T:System.URI mit einer UriTemplate abzugleichen.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolgendarstellung der UriTemplate-Instanz zurück.(Überschreibt Object.ToString().)

Mit einer URI-Vorlage können Sie einen Satz strukturell ähnlicher URIs definieren. Vorlagen bestehen aus zwei Teilen, einem Pfad und einer Abfrage. Ein Pfad besteht aus einer Reihe von Segmenten, die durch einen Schrägstrich (/) voneinander getrennt werden. Jedes Segment kann über einen Literalwert, einen Variablenwert (wird in geschweiften Klammern [{ }] angegeben und muss dem Inhalt genau eines Segments entsprechen) oder einen Platzhalter verfügen (wird als Sternchen [*] angegeben, das als "restlicher Pfad" interpretiert wird), der am Ende des Pfads stehen muss. Der Abfrageausdruck kann vollständig weggelassen werden. Sofern der Abfrageausdruck vorhanden ist, wird eine ungeordnete Reihe von Name-Wert-Paaren angegeben. Bei den Elementen des Abfrageausdrucks kann es sich entweder um literale Paare (? x=2) oder variable Paare (?x={val}) handeln. Alleinstehende Werte sind nicht zulässig. Die folgenden Beispiele veranschaulichen gültige Vorlagenzeichenfolgen:

  • "Wetter/BW/Mannheim"

  • "Wetter/{Bundesland}/{Stadt}"

  • "Wetter/*"

  • "Wetter/{Bundesland}/{Stadt}?forecast=heute

  • "Wetter/{Bundesland}/{Stadt}?forecast={Tag}

Die vorangehenden URI-Vorlagen können zum Organisieren von Wetterberichten verwendet werden. In geschweifte Klammern eingeschlossene Segmente sind Variablen, alle anderen sind Literale. Sie können eine UriTemplate-Instanz in einen Uri konvertieren, indem Sie Variablen durch tatsächliche Werte ersetzen. Wenn Sie beispielsweise in die Vorlage "Wetter/{Bundesland}/{Stadt}" Werte für die Variablen "{Bundesland}" und "{Stadt}" eingeben, erhalten Sie "Wetter/BW/Mannheim". wenn ein möglicher URI gegeben ist, können Sie durch Aufrufen von Match(Uri, Uri) testen, ob er mit einer bestimmten URI-Vorlage übereinstimmt. Außerdem können Sie mithilfe von UriTemplate-Instanzen einen Uri aus einem Satz von Variablenwerten erstellen, indem Sie BindByName(Uri, NameValueCollection) oder BindByPosition(Uri, String[]) aufrufen.

Im folgenden Codebeispiel wird veranschaulicht, wie eine UriTemplate-Instanz erstellt und an einen möglichen URI gebunden und damit abgeglichen wird.

UriTemplate template = new UriTemplate("weather/{state}/{city}?forecast={day}");
Uri prefix = new Uri("http://localhost");

Console.WriteLine("PathSegmentVariableNames:");
foreach (string name in template.PathSegmentVariableNames)
{
    Console.WriteLine("     {0}", name);
}
Console.WriteLine();

Console.WriteLine("QueryValueVariableNames:");
foreach (string name in template.QueryValueVariableNames)
{
    Console.WriteLine("     {0}", name);
}
Console.WriteLine();

Uri positionalUri = template.BindByPosition(prefix, "Washington", "Redmond", "Today");

NameValueCollection parameters = new NameValueCollection();
parameters.Add("state", "Washington");
parameters.Add("city", "Redmond");
parameters.Add("day", "Today");
Uri namedUri = template.BindByName(prefix, parameters);

Uri fullUri = new Uri("http://localhost/weather/Washington/Redmond?forecast=today");
UriTemplateMatch results = template.Match(prefix, fullUri);

Console.WriteLine("Matching {0} to {1}", template.ToString(), fullUri.ToString());

if (results != null)
{
    foreach (string variableName in results.BoundVariables.Keys)
    {
        Console.WriteLine("   {0}: {1}", variableName, results.BoundVariables[variableName]);
    }
}

.NET Framework
Verfügbar seit 3.5
Silverlight
Verfügbar seit 4.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: