ドキュメントごとのデータ(.NET)

グローバルデータは、ドキュメントレベルでメモリに一時的に保存することができます。

AutoCAD プログラムは、マネージアプリケーションをロードするとき、アプリケーションのアセンブリで 1 つまたは複数の PerDocumentClass カスタム属性を照会します。この属性のインスタンスが見つかると、各属性と関連付けられているタイプのインスタンスが、AutoCAD 作図環境で開いているドキュメントそれぞれに対して作成されます。さらに、このタイプの新しいインスタンスは、これ以降に開かれたドキュメントに対しても作成されます。

PerDocumentClass 属性と関連付けられているタイプは、ドキュメントの引数を取る Public コンストラクタとドキュメントの引数を取り、このタイプのインスタンスを返す Public Static Create メソッドのいずれかを提供する必要があります。Create メソッドが存在する場合はこのメソッドが使用され、そうでない場合はコンストラクタが使用されます。タイプインスタンスの作成対象であるドキュメントがドキュメント引数として渡されるので、タイプインスタンスは関連付けられているドキュメントを知ることができます。

次の手順で、PerDocumentClass 属性の使用方法を説明します。

アセンブリのコンテキストで、各ドキュメントに対してインスタンス化するクラスごとに PerDocumentClass 属性を宣言します。
クラスのタイプを PerDocumentClass 属性に渡します。

注: この属性は、アセンブリのコンテキストで宣言される必要があります。

VB.NET

...
Imports Autodesk.AutoCAD.ApplicationServices
Imports Autodesk.AutoCAD.Runtime

<Assembly: PerDocumentClass(GetType(PerDocData))> 

' Defines a global class for constant values
Public NotInheritable Class CSPerDocConsts
    Private Sub New()
    End Sub

    Public Const dbLocVarName As String = "dbLoc"
End Class

' Defines the main class
Public Class PerDocCommands
    ' Creates a command that returns the current value of the per document data
    <CommandMethod("DatabaseLocation")> _
    Public Sub DatabaseLocation()
        Dim acDoc As Document = Application.DocumentManager.MdiActiveDocument
        Dim pDData As PerDocData = DirectCast(acDoc.UserData(CSPerDocConsts.dbLocVarName), PerDocData)
        If pDData Is Nothing Then
            acDoc.Editor.WriteMessage(vbLf & "No user data assigned.")
        Else
            acDoc.Editor.WriteMessage(vbLf & pDData.DbLocation)
        End If
    End Sub
End Class

' Defines the class that wuill be used to initialize the per document data
Public Class PerDocData
    ' Define the internal/member variables of the class
    Private _stDbLoc As String

    ' Expose a public property that returns the value of the internal variable
    Public ReadOnly Property DbLocation() As String
        Get
            Return _stDbLoc
        End Get
    End Property

    ' Public constructor that requires a Document object
    ' Created by AutoCAD when the application is loaded
    Public Sub New(acDoc As Document)
        _stDbLoc = ""
        acDoc.UserData.Add(CSPerDocConsts.dbLocVarName, Me)
    End Sub

    ' Create method: Required constructor for the class
    Public Shared Function Create(acDoc As Document) As PerDocData
        Dim pDData As New PerDocData(acDoc)
        pDData._stDbLoc = "C:\ABCApp\Data\" & acDoc.Name.Remove(acDoc.Name.Length - 4) & ".db"

        Return pDData
    End Function
End Class

C#

...
using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.Runtime;

[assembly: PerDocumentClass(typeof(CSPerDoc.PerDocData))]

namespace CSPerDoc
{
    // Defines a global class for constant values
    public static class CSPerDocConsts
    {
        public const string dbLocVarName = "dbLoc";
    }

    // Defines the main class
    public class PerDocCommands
    {
        // Creates a command that returns the current value of the per document data
        [CommandMethod("DatabaseLocation")]
        public void DatabaseLocation()
        {
            Document acDoc = Application.DocumentManager.MdiActiveDocument;
            PerDocData pDData = (PerDocData) acDoc.UserData[CSPerDocConsts.dbLocVarName];
            if (pDData == null) {
                acDoc.Editor.WriteMessage("\nNo user data assigned.");
            } else {
                acDoc.Editor.WriteMessage("\n" + pDData.DbLocation);
            }
        }
    }

    // Defines the class that wuill be used to initialize the per document data
    public class PerDocData
    {
        // Define the internal/member variables of the class
        private string _stDbLoc;

        // Expose a public property that returns the value of the internal variable
        public string DbLocation
        {
            get { return _stDbLoc; }
        }

        // Public constructor that requires a Document object
        // Created by AutoCAD when the application is loaded
        public PerDocData(Document acDoc)
        {
            _stDbLoc = @"";
            acDoc.UserData.Add(CSPerDocConsts.dbLocVarName, this);
        }

        // Create method: Required constructor for the class
        public static PerDocData Create(Document acDoc)
        {
            PerDocData pDData = new PerDocData(acDoc);
            pDData._stDbLoc = @"C:\\ABCApp\\ProjectData\\" + acDoc.Name.Remove(acDoc.Name.Length - 4) + ".db";

            return pDData;
        }
    }
}

ドキュメントごとのデータ(.NET)

VB.NET

C#

関連概念