IsCustomized 方法 (2003 系統)
取得值,指出指定的文件是否含有 Visual Studio Tools for Office 自訂。
命名空間: Microsoft.VisualStudio.Tools.Applications.Runtime
組件: Microsoft.VisualStudio.Tools.Applications.Runtime (在 Microsoft.VisualStudio.Tools.Applications.Runtime.dll 中)
語法
'宣告
Public Shared Function IsCustomized ( _
documentPath As String _
) As Boolean
'用途
Dim documentPath As String
Dim returnValue As Boolean
returnValue = ServerDocument.IsCustomized(documentPath)
public static bool IsCustomized(
string documentPath
)
參數
documentPath
型別:System. . :: .String您想要檢查是否含有自訂之文件的路徑。
傳回值
如果文件含有 Visual Studio Tools for Office 自訂,則為 true,否則為 false。
例外狀況
例外狀況 | 條件 |
---|---|
ArgumentNullException | documentPath 參數為 null Nothing nullptr Null 參照 (即 Visual Basic 中的 Nothing) ,或空字串,或整個都是空白字元。 |
FileNotFoundException | documentPath 中的檔案不存在。 |
備註
如果文件含有應用程式資訊清單,此資訊清單指向自訂組件和至少一個 entryPoint 項目,則這個方法會傳回 true。entryPoint 項目會指定要在開啟文件時具現化 (Instantiated) 的類別。與組件關聯但是沒有任何 entryPoint 項目的文件是不會執行程式碼,並且不會視為已自訂。如需詳細資訊,請參閱 <entryPoint> 項目 (Visual Studio Tools for Office Reference)。
範例
下列程式碼範例會使用 RemoveCustomization 方法,從指定的文件中移除自訂值。範例首先會呼叫 IsCustomized 方法,判斷文件是否含有 Visual Studio Tools for Office 自訂。這個範例需要對 Microsoft.VisualStudio.Tools.Applications.Runtime 組件的參考,並且在程式碼檔的開頭需要 Microsoft.VisualStudio.Tools.Applications.Runtime 命名空間的 Imports (適用於 Visual Basic) 或 using (適用於 C#) 陳述式。
Private Shared Sub Remove(ByVal fileName As String)
If ServerDocument.IsCustomized(fileName) Then
ServerDocument.RemoveCustomization(fileName)
MsgBox("The customization has been removed.")
Else
MsgBox("The specified document is not " + _
"customized.")
End If
End Sub
private static void Remove(string fileName)
{
if (ServerDocument.IsCustomized(fileName))
{
ServerDocument.RemoveCustomization(fileName);
MessageBox.Show("The customization has been removed.");
}
else
{
MessageBox.Show("The specified document is not " +
"customized.");
}
}
使用權限
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。