In this topic
About creating variables using the New keyword
To instantiate a new object based on an ArcObjects class, use the "New" keyword in the .NET syntax. The class and interface documents are the types of help documents in the ArcObjects namespace reference that provide the necessary information to accomplish this task.
Class documents
In the ArcObjects namespace reference, each class has a help document. These documents detail the name of the class, library to which the class belongs (for example, ArcMapUI, Carto, Server, and so on), platforms on which the class is supported, and all interfaces used.
In the class document, note specifically the name of the class in the title and any interfaces used. The name of the class is the variable instantiation and the interface is the variable declaration.
For example, to create an AddDataDialog object, navigate to the AddDataDialogClass help document and use the title and interfaces to generate the code. See the following screen shot and code example that shows the New keyword:
[VB.NET] Public Class Class2
Public Sub Test()
Dim addDataDialog As IAddDataDialog=New AddDataDialogClass
End Sub
End Class
[C#] public class Class2
{
public void test()
{
IAddDataDialog addDataDialog=new AddDataDialogClass();
}
}
If multiple interfaces are available in the class help document, choose the one that best suits your programming needs. Click an interface's link to view its properties, methods, and events.
Interface documents
- Interface name in the title
- Classes that implement the interface
The name of the interface is the variable declaration and the class is the variable instantiation.
For example, to create an AddDataDialog object with the IAddDataDialog interface displayed in the reading pane, translates into the .NET code. See the following screen shot and code example that shows the New keyword:
[VB.NET] Public Class Class2
Public Sub Test()
Dim addDataDialog As IAddDataDialog=New AddDataDialogClass
End Sub
End Class
[C#] public class Class2
{
public void test()
{
IAddDataDialog addDataDialog=new AddDataDialogClass();
}
}
See Also:
Understanding the ArcObjects namespace referenceTo use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):
Development licensing | Deployment licensing |
---|---|
ArcGIS for Desktop Basic | ArcGIS for Desktop Basic |
ArcGIS for Desktop Standard | ArcGIS for Desktop Standard |
ArcGIS for Desktop Advanced | ArcGIS for Desktop Advanced |
Engine Developer Kit | Engine |