CustomStrokes.Item-Eigenschaft (String)

Artikel
11/26/2008

Ruft die Strokes-Auflistung mit dem angegebenen Namen aus der CustomStrokes-Auflistung ab.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property Item ( _
    name As String _
) As Strokes
'Usage
Dim instance As CustomStrokes
Dim name As String
Dim value As Strokes

value = instance.Item(name)

public Strokes Item[
    string name
] { get; }

public:
property Strokes^ Item[String^ name] {
    Strokes^ get (String^ name);
}

/** @property */
public Strokes get_Item(
    String name
)

JScript unterstützt keine indizierten Eigenschaften.

Parameter

name
Typ: System.String
Der Name der Strokes-Auflistung, die aus der Auflistung zurückgegeben werden soll.

Eigenschaftenwert

Typ: Microsoft.Ink.Strokes
Die angegebene Strokes-Auflistung in der CustomStrokes-Auflistung.

Hinweise

Eine System.ArgumentException wird ausgelöst, wenn der Parameter name keinem vorhandenen Member der CustomStrokes-Auflistung entspricht.

Hinweis

Verwenden Sie in C# anstelle der Item-Eigenschaft der Auflistung den Indexer der Auflistung, wie im folgenden Beispiel gezeigt.

Beispiele

In diesem Beispiel wird von einer Methode true zurückgegeben, wenn die CustomStrokes-Auflistung eines Ink-Objekts eine Strokes-Auflistung mit dem angegebenen Namen enthält. Wenn keine Strokes-Auflistung mit dem angegebenen Namen vorhanden ist, wird eine Ausnahme ausgelöst und die Methode gibt false zurück.

Private Function CustomStrokesCollectionExists(ByVal mName As String, ByVal mInk As Ink) As Boolean
    Try
        Dim S As Strokes = mInk.CustomStrokes(mName)
        ' In VB, you can also access the named collections by using the Item property:
        ' Dim S As Strokes = mInk.CustomStrokes.Item(mName)
        '
        ' if the previous statement did not raise an exception, 
        ' the named Strokes collection exists
        Return True

    Catch E As ArgumentException
        ' this exception is raised when the named collection does not exist

    Catch E As Exception
        ' in case another type of exception is raised

    End Try
    Return False
End Function

private bool CustomStrokesCollectionExists(string mName, Ink mInk)
{
    try
    {
        Strokes S = mInk.CustomStrokes[mName];
        // In C#, the Item property is not available. The following won't compile:
        // Strokes S = mInk.CustomStrokes.Item[mName];

        // if the previous statement did not throw an exception, 
        // the named Strokes collection exists
        return true;
    }
    catch (ArgumentException)
    {
        // this exception is raised when the named collection does not exist
    }
    catch (Exception)
    {
        // in case another type of exception is raised
    }
    return false;
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.