このセクションでは、オブジェクトを作成する方法、オブジェクトの参照を代入する方法、オブジェクトを削除する方法について説明します。
Domino のクラスに基づいてオブジェクトを作成するか、既存の Domino オブジェクトへの参照を代入することで、Domino の機能にアクセスできます。オブジェクトの作成と代入のどちらが適切であるかは、Domino のクラスと実行する操作によって異なります。
Domino オブジェクトを作成して、参照変数にそのオブジェクトを代入するには、Dim ステートメントで New キーワードを使用します。クラス名に続けて、パラメータをカッコで囲んで指定します。次のステートメントは、ローカルに保存されている SALES.NSF の NotesDatabase オブジェクトを作成し、そのオブジェクトを変数 db に代入します。
Dim db As New NotesDatabase("", "SALES.NSF")Set ステートメントで New キーワードを使用してオブジェクトを作成することもできます。最初に Dim ステートメントで変数を宣言しておかなければなりません。
Dim db As NotesDatabase
Set db = New NotesDatabase("", "SALES.NSF")New は、NotesACL、NotesAgent、NotesDocumentCollection、NotesEmbeddedObject、NotesRichTextTab、NotesUIDocument、NotesView、NotesViewColumn、NotesViewEntry、NotesViewEntryCollection、NotesViewNavigator では使用できません。これらのオブジェクトにアクセスするには、必ず代入を使用してください。
既存の Domino オブジェクトを参照変数に代入するには、Set ステートメントを使用します。次のステートメントは、GetNextDatabase (DbDirectory クラスのメソッド) からの戻り値を db に代入します。
Set db = srv.GetNextDatabase()Set ステートメントを使用すると、1 つのオブジェクトを参照変数に代入できます。Set ステートメントを使用してオブジェクトの配列またはリストを変数に代入しないでください。以下に例を示します。
views = db.Viewsただし
Set view = db.Views(0)LotusScript® の Delete ステートメントを使用してオブジェクトを削除すると、LotusScript のオブジェクトは破壊されますが、Domino オブジェクトには影響しません。 データベースから文書やアイテムなどの Domino オブジェクトを削除するには、適切な Remove メソッドを使用します。
すでに Domino オブジェクトで使用されている参照変数を新規 Domino オブジェクトに代入すると、最初の Domino オブジェクトは削除されます。
Domino オブジェクトを削除すると、そのオブジェクトに含まれていたオブジェクトはすべて失われます。例えば、NotesDatabase オブジェクトを削除したり閉じたりすると、そのデータベース内で参照される NotesDocument オブジェクトはすべて削除されます。