Add Method (TdQueryBand)

Adds a key=value pair as a Query Band.

Syntax

'Declaration
 
Public Sub Add( _
   ByVal key As String, _
   ByVal value As Object _
)

'Usage
 
Dim instance As TdQueryBand
Dim key As String
Dim value As Object
 
instance.Add(key, value)

public void Add( 
   string key,
   object value
)

public:
void Add( 
   String^ key,
   Object^ value
)

Exceptions

Exception	Description
System.ArgumentNullException	A null has been passed in as the key.
System.ArgumentException	A Query Band that contains the same key already exists or the key is String.Empty.

Remarks

When this method is called to add a Query Band, the following task is performed based upon the scenario:

Scenario: key does not exist.

Task: the key=value pair will be added to this instance.
Scenario: key exists and value is not null.

Task: An ArgumentException will get thrown.
Scenario: key exists and value is null.

Task: An ArgumentException will get thrown.

Requirements

Target Platforms: Windows 8.1, Windows 10, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019