Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

UriTemplateTable classe

 

Date de publication : novembre 2016

Classe qui représente un jeu associatif d'objets UriTemplate.

Espace de noms:   System
Assembly:  System.ServiceModel (dans System.ServiceModel.dll)

System.Object
  System.UriTemplateTable

public class UriTemplateTable

NomDescription
System_CAPS_pubmethodUriTemplateTable()

Initialise une nouvelle instance de la classe UriTemplateTable.

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

Initialise une nouvelle instance de la classe UriTemplateTable avec la collection spécifiée de paires clé/valeur.

System_CAPS_pubmethodUriTemplateTable(Uri)

Initialise une nouvelle instance de la classe UriTemplateTable avec l'adresse de base spécifiée.

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

Initialise une nouvelle instance de la classe UriTemplateTable avec l'adresse de base spécifiée et la collection de paires clé/valeur.

NomDescription
System_CAPS_pubpropertyBaseAddress

Obtient et définit l'adresse de base de l'instance UriTemplateTable.

System_CAPS_pubpropertyIsReadOnly

Obtient une valeur qui spécifie si l'objet UriTemplateTable est en lecture seule.

System_CAPS_pubpropertyKeyValuePairs

Obtient une collection de paires clé/valeur qui se composent d'objets UriTemplate et de leurs données associées.

System_CAPS_pubpropertyOriginalBaseAddress

Obtient l'adresse de base d'origine.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodMakeReadOnly(Boolean)

Met UriTemplateTable en lecture seule.

System_CAPS_pubmethodMatch(Uri)

Tente de faire correspondre un Uri candidat et UriTemplateTable.

System_CAPS_pubmethodMatchSingle(Uri)

Tente de faire correspondre un Uri candidat et UriTemplateTable.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

Un objet UriTemplateTable est un jeu associatif d'objets UriTemplate liés à un objet choisi par le développeur. Elle vous permet de faire correspondre les URI (Uniform Resource Identifiers) des candidats par rapport aux modèles du jeu et de récupérer les données associées aux modèles correspondants. Le contenu de l'objet UriTemplateTable peut être modifié jusqu'à ce que la méthode MakeReadOnly(Boolean) soit appelée, auquel cas l'un des types de validation suivants intervient :

  • Lorsque MakeReadOnly(Boolean) est appelée en passant dans false, le UriTemplateTable vérifications pour vous assurer que la table ne contient pas plusieurs modèles structurellement équivalents. Si elle recherche des modèles de ce type, elle lève une exception. Ce type de validation est utilisé conjointement à la méthode MatchSingle(Uri) lorsque vous souhaitez garantir qu'un seul modèle correspond à un URI entrant.

  • Lorsque MakeReadOnly(Boolean) est appelée en passant dans true, plusieurs modèles structurellement équivalents peuvent être contenus dans un UriTemplateTable. Toutefois, toutes les chaînes de demande des modèles ne doivent pas être ambiguës ; les chaînes de demande identiques sont autorisées.Pour plus d'informations sur les chaînes de demande ambiguës, consultez UriTemplate et UriTemplateTable.

Le code suivant indique comment créer un objet UriTemplateTable, le remplir et l'utiliser pour établir une correspondance par rapport à un objet Uri de candidat.

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
Disponible depuis 3.5

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: