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

UriTemplateTable-Klasse

 

Veröffentlicht: Oktober 2016

Eine Klasse, die einen assoziativen Satz von UriTemplate-Objekten darstellt.

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

System.Object
  System.UriTemplateTable

public class UriTemplateTable

NameBeschreibung
System_CAPS_pubmethodUriTemplateTable()

Initialisiert eine neue Instanz der UriTemplateTable-Klasse.

System_CAPS_pubmethodUriTemplateTable(IEnumerable<KeyValuePair<UriTemplate, Object>>)

Initialisiert eine neue Instanz der UriTemplateTable-Klasse mit der angegebenen Auflistung von Schlüssel-Wert-Paaren.

System_CAPS_pubmethodUriTemplateTable(Uri)

Initialisiert eine neue Instanz der UriTemplateTable-Klasse mit der angegebenen Basisadresse.

System_CAPS_pubmethodUriTemplateTable(Uri, IEnumerable<KeyValuePair<UriTemplate, Object>>)

Initialisiert eine neue Instanz der UriTemplateTable-Klasse mit der angegebenen Basisadresse und Auflistung von Schlüssel-Wert-Paaren.

NameBeschreibung
System_CAPS_pubpropertyBaseAddress

Ruft die Basisadresse für die UriTemplateTable-Instanz ab oder legt sie fest.

System_CAPS_pubpropertyIsReadOnly

Ruft einen Wert ab, der angibt, ob die UriTemplateTable schreibgeschützt ist.

System_CAPS_pubpropertyKeyValuePairs

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die aus UriTemplate-Objekten und deren zugeordneten Daten bestehen.

System_CAPS_pubpropertyOriginalBaseAddress

Ruft die ursprüngliche Basisadresse ab.

NameBeschreibung
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_pubmethodMakeReadOnly(Boolean)

Macht die UriTemplateTable schreibgeschützt.

System_CAPS_pubmethodMatch(Uri)

Versucht, einen möglichen Uri mit der UriTemplateTable abzugleichen.

System_CAPS_pubmethodMatchSingle(Uri)

Versucht, einen möglichen Uri mit der UriTemplateTable abzugleichen.

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Eine UriTemplateTable ist ein assoziativer Satz von UriTemplate-Objekten, die an ein Objekt nach Wahl des Entwicklers gebunden sind. Sie ermöglicht Ihnen, mögliche URIs (Uniform Resource Identifiers) mit den Vorlagen im Satz abzugleichen und die den übereinstimmenden Vorlagen zugeordneten Daten abzurufen.. Der Inhalt der UriTemplateTable kann geändert werden, bis die MakeReadOnly(Boolean)-Methode aufgerufen wird und eine der folgenden Validierungen erfolgt:

  • Wenn MakeReadOnly(Boolean) bei der Übergabe von false aufgerufen wird, überprüft die UriTemplateTable, ob die Tabelle mehrere strukturell äquivalente Vorlagen enthält. Wenn solche Vorlagen gefunden werden, wird eine Ausnahme ausgelöst. Diese Validierung wird zusammen mit MatchSingle(Uri) verwendet, wenn sichergestellt werden soll, dass nur eine Vorlage einem eingehenden URI entspricht.

  • Wenn MakeReadOnly(Boolean) bei der Übergabe von true aufgerufen wird, können in einer UriTemplateTable mehrere strukturell äquivalente Vorlagen enthalten sein. Abfragezeichenfolgen in den Vorlagen dürfen jedoch nicht mehrdeutig sein; identische Abfragezeichenfolgen sind zulässig.Weitere Informationen finden Sie unter zu mehrdeutigen Abfragezeichenfolgen finden Sie unter UriTemplate und UriTemplateTable.

Im folgenden Codebeispiel wird veranschaulicht, wie eine UriTemplateTable erstellt, gefüllt und für den Abgleich mit einem möglichen Uri verwendet wird.

Uri prefix = new Uri("http://localhost/");

//Create a series of templates
UriTemplate weatherByCity  = new UriTemplate("weather/ state}/ city}");
UriTemplate weatherByCountry = new UriTemplate("weather/ country}/ village}");       
UriTemplate weatherByState = new UriTemplate("weather/ state}");
UriTemplate traffic = new UriTemplate("traffic/*");
UriTemplate wildcard = new UriTemplate("*");

//Create a template table
UriTemplateTable table = new UriTemplateTable(prefix);
//Add each template to the table with some associated data
table.KeyValuePairs.Add(new KeyValuePair<UriTemplate, Object>(weatherByCity, "weatherByCity"));
table.KeyValuePairs.Add(new KeyValuePair<UriTemplate, Object>(weatherByCountry, "weatherByCountry"));
table.KeyValuePairs.Add(new KeyValuePair<UriTemplate, Object>(weatherByState, "weatherByState"));
table.KeyValuePairs.Add(new KeyValuePair<UriTemplate, Object>(traffic, "traffic"));

table.MakeReadOnly(true);
Console.WriteLine("KeyValuePairs:");
foreach (KeyValuePair<UriTemplate, Object> keyPair in table.KeyValuePairs)
{
    Console.WriteLine("     0},  1}", keyPair.Key, keyPair.Value);
}

Console.WriteLine();

//Call MatchSingle to retrieve some match results:
ICollection<UriTemplateMatch> results = null;
Uri weatherInSeattle = new Uri("http://localhost/weather/Washington/Seattle");

results = table.Match(weatherInSeattle);
if( results != null)
{
    Console.WriteLine("Matching templates:");
    foreach (UriTemplateMatch match in results)
    {
        Console.WriteLine("    0}", match.Template);
    }
}

.NET Framework
Verfügbar seit 3.5

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: