ObjectDescriptor Constructor(String)

Initializes a new instance of the class, with specified server class (ProgID) or a URL string.

Syntax

public ObjectDescriptor( 
   string descriptorString
)

public:
ObjectDescriptor( 
   String^ descriptorString
)

'Declaration
 
Public Function New( _
   ByVal descriptorString As String _
)

'Usage
 
Dim descriptorString As String
 
Dim instance As New ObjectDescriptor(descriptorString)

Parameters

descriptorString: Contains the descriptor string for the object.
The value of this parameter cannot be null (Nothing in Visual Basic).

Exceptions

Exception Description

Exception	Description
System.ArgumentNullException	A `null` reference (`Nothing` in Visual Basic) is passed to a method that does not accept it as a valid argument. This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

System.ArgumentNullException

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

Remarks

The descriptorString may contain one of the following:

A server class, i.e. ProgID (or {CLSID}) of the object.
A string in the form "\\machineName\serverClass".
A URI of the object.

In languages that support implicit conversions (such as C# or VB.NET), in many cases you do not have call this constructor explicitly. When indicated, a call to an available equivalent implicit conversion operator will be created by the compiler automatically.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

Reference

ObjectDescriptor Class
ObjectDescriptor Members
Overload List

Documentation Home, Send Feedback. Resources: Knowledge Base, Product Downloads. Technical support: Online Forums, FAQ.

Missing some example? Ask us for it on our Online Forums! You do not have to own a commercial license in order to use Online Forums, and we reply to every post.