DocumentBase.ProtectDocument 메서드

아티클
05/08/2013

캐시된 데이터가 저장된 후 문서에 암호 보호를 다시 적용할 수 있는 옵션을 제공합니다.

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word.v4.0.Utilities(Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

구문

‘선언
Protected Overridable Sub ProtectDocument

protected virtual void ProtectDocument()

설명

문서가 암호를 사용하여 보호되어 있고 이 문서에 런타임에 변경될 수 있는 캐시된 데이터가 들어 있는 경우 Word용 문서 수준 프로젝트에서 이 메서드를 재정의합니다.이 메서드를 구현할 때는 Protect 메서드를 사용하여 문서를 보호합니다.

기본적으로 암호로 보호된 문서의 캐시된 데이터에 대한 변경 사항은 문서가 저장될 때 유지되지 않습니다.캐시된 데이터의 변경 사항을 저장하려면 프로젝트에서 다음 메서드를 재정의해야 합니다.

UnprotectDocument.문서가 저장되면 Microsoft Visual Studio Tools for Office Runtime에서 이 메서드를 호출합니다.이 메서드에 문서의 보호를 임시로 해제하는 코드를 추가합니다.이를 통해 캐시된 데이터의 변경 사항을 저장할 수 있습니다.
ProtectDocument.문서가 저장된 후 Microsoft Visual Studio Tools for Office Runtime에서 이 메서드를 호출합니다.이 메서드에 문서에 보호를 다시 적용하는 코드를 추가합니다.

자세한 내용은 방법: 암호로 보호된 문서의 데이터 캐시을 참조하십시오.

암호 보호와 관련이 없는 오류로 인해 캐시된 데이터를 저장할 수 없는 경우에도 Microsoft Visual Studio Tools for Office Runtime에서는 ProtectDocument 메서드를 호출합니다.예를 들어 ICachedType 인터페이스를 구현하여 캐시된 데이터가 문서에 저장되는 방식을 사용자 지정하는 경우, ICachedType 구현에서 캐시된 데이터를 저장할 수 없게 하는 예외가 throw되더라도 ProtectDocument 메서드가 호출됩니다.

예제

다음 코드 예제에서는 ProtectDocument 메서드를 재정의하여 UnprotectDocument 메서드 재정의를 통해 해제된 보호를 다시 적용하는 방법을 보여 줍니다.이 코드에서는 암호가 securelyStoredPassword라는 필드에 저장되어 있다고 가정합니다.이 예제를 사용하려면 문서 수준 프로젝트 ThisDocument 클래스에서 실행하십시오.

<CachedAttribute()> _
Public CachedString As String = "This string is cached in the document."

Private protectionTypeValue As Word.WdProtectionType

Protected Overrides Sub UnprotectDocument()
    If Me.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
        protectionTypeValue = Me.ProtectionType
        Me.Unprotect(securelyStoredPassword)
    End If
End Sub

Protected Overrides Sub ProtectDocument()
    Me.Protect(protectionTypeValue, password:=securelyStoredPassword)
End Sub

[CachedAttribute]
public string CachedString = "This string is cached in the document.";

private Word.WdProtectionType protectionTypeValue;

protected override void UnprotectDocument()
{
    if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
    {
        protectionTypeValue = this.ProtectionType;
        this.Unprotect(ref securelyStoredPassword);
    }
}

protected override void ProtectDocument()
{
    this.Protect(protectionTypeValue, ref missing,
        ref securelyStoredPassword, ref missing, ref missing);
}