SecurityTokenHandler.CanReadToken Méthode

Définition

Espace de noms:

System.IdentityModel.Tokens

Assembly:

System.IdentityModel.dll

Retourne une valeur qui indique si le jeton spécifié peut être désérialisé en tant que jeton du type traité par cette instance.

Surcharges

CanReadToken(String)	Retourne une valeur qui indique si la chaîne spécifiée peut être désérialisée comme un jeton du type traité par cette instance.
CanReadToken(XmlReader)	Retourne une valeur qui indique si l'élément XML référencé par le lecteur XML spécifié peut être lu comme un jeton du type traité par cette instance.

CanReadToken(String)

Retourne une valeur qui indique si la chaîne spécifiée peut être désérialisée comme un jeton du type traité par cette instance.

public:
 virtual bool CanReadToken(System::String ^ tokenString);

public virtual bool CanReadToken (string tokenString);

abstract member CanReadToken : string -> bool
override this.CanReadToken : string -> bool

Public Overridable Function CanReadToken (tokenString As String) As Boolean

Paramètres

tokenString

String

Chaîne de jeton à lire.

Retours

Boolean

true si la méthode ReadToken(String) peut lire l'élément ; sinon, false. La valeur par défaut est false.

Remarques

L'implémentation par défaut retourne toujours false.

Si vous remplacez cette méthode, vous devez également remplacer la SecurityTokenHandler.ReadToken méthode pour fournir la logique de désérialisation du jeton.

CanReadToken(XmlReader)

Retourne une valeur qui indique si l'élément XML référencé par le lecteur XML spécifié peut être lu comme un jeton du type traité par cette instance.

public:
 virtual bool CanReadToken(System::Xml::XmlReader ^ reader);

public virtual bool CanReadToken (System.Xml.XmlReader reader);

abstract member CanReadToken : System.Xml.XmlReader -> bool
override this.CanReadToken : System.Xml.XmlReader -> bool

Public Overridable Function CanReadToken (reader As XmlReader) As Boolean

Paramètres

reader

XmlReader

Lecteur XML positionné au niveau d'un élément de début. Le lecteur ne doit pas être avancé par cette méthode.

Retours

Boolean

true si la méthode ReadToken(XmlReader) peut lire l'élément ; sinon, false. La valeur par défaut est false.

Exemples

Le code suivant montre comment remplacer la CanReadToken méthode pour déterminer si un jeton peut être lu par un gestionnaire. Le code est extrait de l’exemple Custom Token . Cet exemple fournit des classes personnalisées qui permettent le traitement des jetons web simples (SWT). Pour plus d’informations sur cet exemple et d’autres exemples disponibles pour WIF et où les télécharger, consultez Index d’exemple de code WIF.

/// <summary>
/// Indicates whether the current XML element can be read as a token of the type handled by this instance.
/// </summary>
/// <param name="reader">An XML reader positioned at a start element. The reader should not be advanced.</param>
/// <returns>True if the ReadToken method can the element.</returns>
public override bool CanReadToken( XmlReader reader )
{
    bool canRead = false;

    if ( reader != null )
    {
        if ( reader.IsStartElement( BinarySecurityToken)
            && ( reader.GetAttribute( ValueType ) == SimpleWebTokenConstants.ValueTypeUri ) )
        {
            canRead = true;
        }
    }

    return canRead;
}

Remarques

L'implémentation par défaut retourne toujours false.

Une classe dérivée vérifie l’élément auquel le lecteur fait référence afin de déterminer si le instance peut désérialiser un jeton de sécurité. Cela s’effectue généralement par un appel à la IsStartElement méthode avec l’élément et les chaînes d’espace de noms appropriés spécifiés. Si vous remplacez CanReadKeyIdentifierClause, vous devez également remplacer la SecurityTokenHandler.ReadToken méthode ou la SecurityTokenHandler.ReadToken méthode pour fournir la logique permettant de désérialiser la clause d’identificateur de clé.