ExtendedProperties.Remove-Methode (Guid)

Artikel
11/26/2008

Entfernt ein ExtendedProperty-Objekt aus der ExtendedProperties-Auflistung.

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

Syntax

'Declaration
Public Sub Remove ( _
    id As Guid _
)
'Usage
Dim instance As ExtendedProperties
Dim id As Guid

instance.Remove(id)

public void Remove(
    Guid id
)

public:
void Remove(
    Guid id
)

public void Remove(
    Guid id
)

public function Remove(
    id : Guid
)

Parameter

id
Typ: System.Guid
Die GUID (Globally Unique Identifier) des ExtendedProperty-Objekts, das aus der ExtendedProperties-Auflistung entfernt werden soll.

Hinweise

Diese Methode entfernt das ExtendedProperty-Objekt nur aus einem Snapshot der Freihanddaten oder aus einem Verweis auf die Freihanddaten. Sie entfernt das ExtendedProperty-Objekt nicht aus den tatsächlichen Freihanddaten.

Beispiele

In diesem Beispiel wird jedes Stroke-Objekt in einer Strokes-Auflistung überprüft. Wenn die ExtendedProperties-Auflistung von Stroke Eigenschaften enthält, denen spezielle Timestamp-GUID-Objekte zugeordnet sind, wird die ExtendedProperty aus der Auflistung gelöscht.

Private Sub RemoveAllTimeStampProperties()
    ' STROKE_START_GUID and STROKE_END_GUID
    ' are class level string const set via GUID generator
    Dim strokeStartGuid As Guid = New Guid(STROKE_START_GUID)
    Dim strokeEndGuid As Guid = New Guid(STROKE_END_GUID)

    ' access the Strokes property via using statement
    ' to insure that the object mStrokes is disposed when finished
    ' Otherwise, you will have a memory leak
    Using mStrokes As Strokes = mInkObject.Ink.Strokes
        For Each S As Stroke In mStrokes
            If S.ExtendedProperties.Contains(strokeStartGuid) Then
                S.ExtendedProperties.Remove(strokeStartGuid)
            End If
            If S.ExtendedProperties.Contains(strokeEndGuid) Then
                S.ExtendedProperties.Remove(strokeEndGuid)
            End If
        Next
    End Using
End Sub

private void RemoveAllTimeStampProperties()
{
    // STROKE_START_GUID and STROKE_END_GUID
    // are class level string const set via GUID generator
    Guid strokeStartGuid = new Guid(STROKE_START_GUID);
    Guid strokeEndGuid = new Guid(STROKE_END_GUID);

    // access the Strokes property via using statement
    // to insure that the object mStrokes is disposed when finished
    // Otherwise, you will have a memory leak
    using (Strokes mStrokes = mInkObject.Ink.Strokes)
    {
        foreach (Stroke S in mStrokes)
        {
            if (S.ExtendedProperties.Contains(strokeStartGuid))
            {
                S.ExtendedProperties.Remove(strokeStartGuid);
            }
            if (S.ExtendedProperties.Contains(strokeEndGuid))
            {
                S.ExtendedProperties.Remove(strokeEndGuid);
            }
        }
    }
}

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.