CustomStrokes.Item, propriété (String)

Article
11/05/2008

Mise à jour : November 2007

Obtient la collection Strokes avec le nom spécifié dans la collection CustomStrokes.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Item ( _
    name As String _
) As Strokes
'Utilisation
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 ne prend pas en charge les propriétés indexées.

Paramètres

name
Type : System.String
Nom de la collection Strokes à retourner à partir de la collection.

Valeur de propriété

Type : Microsoft.Ink.Strokes
Collection Strokes spécifiée dans la collection CustomStrokes.

Notes

Une exception System.ArgumentException (page pouvant être en anglais) est levée si le name ne correspond pas à un membre existant de la collection CustomStrokes.

Remarque :
En C#, utilisez l'indexeur de collection comme indiqué dans l'exemple suivant, au lieu d'utiliser la propriété Item de la collection.

Exemples

Dans cet exemple, une méthode retourne la valeur true si la collection CustomStrokes d'un objet Ink contient une collection Strokes avec le nom spécifié. Si une collection Strokes n'existe pas avec le nom spécifié, une exception est levée et la méthode retourne la valeur false.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.