SecurityTokenHandler.CanReadToken Methode

Definition

Namespace:

System.IdentityModel.Tokens

Assembly:

System.IdentityModel.dll

Gibt einen Wert zurück, der angibt, ob das angegebene Token als Token des Typs deserialisiert werden kann, der von dieser Instanz verarbeitet wird.

Überlädt

CanReadToken(String)	Gibt einen Wert zurück, der angibt, ob die angegebene Zeichenfolge als Token des Typs deserialisiert werden kann, der von dieser Instanz verarbeitet wird.
CanReadToken(XmlReader)	Gibt einen Wert zurück, der angibt, ob das XML-Element, auf das aus dem angegebenen XML-Reader verwiesen wird, als Token des Typs gelesen werden kann, der von dieser Instanz verarbeitet wird.

CanReadToken(String)

Gibt einen Wert zurück, der angibt, ob die angegebene Zeichenfolge als Token des Typs deserialisiert werden kann, der von dieser Instanz verarbeitet wird.

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

Parameter

tokenString

String

Die zu lesende Tokenzeichenfolge.

Gibt zurück

Boolean

true, wenn die ReadToken(String)-Methode das Element lesen kann, andernfalls false. Der Standardwert ist false.

Hinweise

Die Standardimplementierung gibt immer false zurück.

Wenn Sie diese Methode überschreiben, müssen Sie auch die -Methode überschreiben, um die SecurityTokenHandler.ReadToken Logik zum Deserialisieren des Tokens bereitzustellen.

CanReadToken(XmlReader)

Gibt einen Wert zurück, der angibt, ob das XML-Element, auf das aus dem angegebenen XML-Reader verwiesen wird, als Token des Typs gelesen werden kann, der von dieser Instanz verarbeitet wird.

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

Parameter

reader

XmlReader

Ein XML-Reader, bei einem Start-Element positioniert. Der Reader sollte durch diese Methode nicht erweitert werden.

Gibt zurück

Boolean

true, wenn die ReadToken(XmlReader)-Methode das Element lesen kann, andernfalls false. Der Standardwert ist false.

Beispiele

Der folgende Code zeigt, wie die CanReadToken -Methode überschrieben wird, um zu bestimmen, ob ein Token von einem Handler gelesen werden kann. Der Code stammt aus dem Custom Token Beispiel. Dieses Beispiel enthält benutzerdefinierte Klassen, die die Verarbeitung von Simple Web Token (SWT) ermöglichen. Informationen zu diesem Beispiel und anderen für WIF verfügbaren Beispielen sowie zu den Informationen zum Herunterladen finden Sie unter WIF-Codebeispielindex.

/// <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;
}

Hinweise

Die Standardimplementierung gibt immer false zurück.

Eine abgeleitete Klasse überprüft das Element, auf das sich der Leser bezieht, um zu bestimmen, ob die instance ein Sicherheitstoken deserialisieren kann. Dies wird in der Regel durch einen Aufruf der IsStartElement -Methode mit den entsprechenden Element- und Namespacezeichenfolgen erreicht. Wenn Sie überschreiben CanReadKeyIdentifierClause, müssen Sie auch die -Methode oder die SecurityTokenHandler.ReadTokenSecurityTokenHandler.ReadToken -Methode überschreiben, um die Logik zum Deserialisieren der Schlüsselbezeichnerklausel bereitzustellen.