XmlStreamStore.GetAnnotations 方法

定义

命名空间:

System.Windows.Annotations.Storage

程序集:

PresentationFramework.dll

返回存储区中所有批注的列表。

重载

GetAnnotations()	返回存储区中所有批注的列表。
GetAnnotations(ContentLocator)	返回批注的列表，这些批注具有 Anchors 且定位器以匹配 ContentLocatorPart 序列开头。

示例

以下示例演示如何使用 GetAnnotations 该方法来确定存储中是否包含任何批注。

// ---------------------------- CloseFile -----------------------------
private void CloseFile()
{
    // If there are existing annotations, then they should be saved.
    if (_annStore.GetAnnotations().Count > 0)
    {
        string backupFile = _fileName + ".annotations" + ".xml";
        FileStream backupStream = new FileStream(backupFile, FileMode.Create);
        CopyStream(_annotationBuffer, backupStream);
        _annStore.Flush();
        _annServ.Disable();
    }
}

GetAnnotations()

返回存储区中所有批注的列表。

public:
 override System::Collections::Generic::IList<System::Windows::Annotations::Annotation ^> ^ GetAnnotations();

public override System.Collections.Generic.IList<System.Windows.Annotations.Annotation> GetAnnotations ();

override this.GetAnnotations : unit -> System.Collections.Generic.IList<System.Windows.Annotations.Annotation>

Public Overrides Function GetAnnotations () As IList(Of Annotation)

返回

IList<Annotation>

存储区中当前存在的所有批注的列表。

例外

ObjectDisposedException

已在存储区上调用 Dispose。

示例

以下示例演示如何使用 GetAnnotations 该方法来确定存储区中是否有任何批注。

// ---------------------------- CloseFile -----------------------------
private void CloseFile()
{
    // If there are existing annotations, then they should be saved.
    if (_annStore.GetAnnotations().Count > 0)
    {
        string backupFile = _fileName + ".annotations" + ".xml";
        FileStream backupStream = new FileStream(backupFile, FileMode.Create);
        CopyStream(_annotationBuffer, backupStream);
        _annStore.Flush();
        _annServ.Disable();
    }
}

注解

此方法 GetAnnotations 永远不会返回 null;但是，如果存储区不包含批注，则列表可能为空。

另请参阅

• GetAnnotation(Guid)
• GetAnnotations(ContentLocator)

GetAnnotations(ContentLocator)

返回批注的列表，这些批注具有 Anchors 且定位器以匹配 ContentLocatorPart 序列开头。

public:
 override System::Collections::Generic::IList<System::Windows::Annotations::Annotation ^> ^ GetAnnotations(System::Windows::Annotations::ContentLocator ^ anchorLocator);

public override System.Collections.Generic.IList<System.Windows.Annotations.Annotation> GetAnnotations (System.Windows.Annotations.ContentLocator anchorLocator);

override this.GetAnnotations : System.Windows.Annotations.ContentLocator -> System.Collections.Generic.IList<System.Windows.Annotations.Annotation>

Public Overrides Function GetAnnotations (anchorLocator As ContentLocator) As IList(Of Annotation)

参数

anchorLocator

ContentLocator

为其返回匹配批注的起始 ContentLocatorPart 序列。

返回

IList<Annotation>

具有 Anchors 且定位器以给定 anchorLocator 开始并与之匹配的批注列表；如果找不到匹配的批注，则为 null。

示例

以下示例演示如何使用 GetAnnotations 该方法来确定存储区中是否有任何批注。

// ---------------------------- CloseFile -----------------------------
private void CloseFile()
{
    // If there are existing annotations, then they should be saved.
    if (_annStore.GetAnnotations().Count > 0)
    {
        string backupFile = _fileName + ".annotations" + ".xml";
        FileStream backupStream = new FileStream(backupFile, FileMode.Create);
        CopyStream(_annotationBuffer, backupStream);
        _annStore.Flush();
        _annServ.Disable();
    }
}

注解

此方法 GetAnnotations 在内部使用 StartsWith 类的方法 ContentLocator 搜索并匹配要返回的批注。

另请参阅

• GetAnnotation(Guid)
• StartsWith(ContentLocator)