Namespace:
IBM.CTG
Assembly: IBM.CTG.Client (in IBM.CTG.Client.dll) Version: 9.0.0.2
Assembly: IBM.CTG.Client (in IBM.CTG.Client.dll) Version: 9.0.0.2
Syntax
C# |
---|
public Container CreateContainer( string containerName, byte[] charData, int ccsid ) |
Visual Basic |
---|
Public Function CreateContainer ( _ containerName As String, _ charData As Byte(), _ ccsid As Integer _ ) As Container |
Visual C++ |
---|
public: Container^ CreateContainer( String^ containerName, array<unsigned char>^ charData, int ccsid ) |
Parameters
- containerName
- Type: System..::..String
The name of the new Container.
- charData
- Type: array<System..::..Byte>[]()[][]
A byte array to be placed in the Container.
- ccsid
- Type: System..::..Int32
The CCSID of the character data supplied.
Return Value
The newly created Container.
Remarks
The Container name must be between 1 and 16 characters in length and must consist of only the following types of character:
- Uppercase characters (A-Z)
- Lowercase characters (a-z)
- Digits (0-9)
- Special characters < > $ @ # / % & ? ! : | " = ' ; . - and _
Exceptions
Exception | Condition |
---|---|
IBM.CTG..::..InvalidNameException | An invalid name was specified for the Container. |
System..::..ArgumentNullException | name is nullNothingnullptra null reference (Nothing in Visual Basic). |
System..::..ArgumentOutOfRangeException | ccsid is set to zero or a negative number. |
System..::..NotSupportedException | ccsid is not a supported CCSID. |
IBM.CTG..::..ContainerExistsException | A Container with the same name already exists within the Channel. |
System..::..ObjectDisposedException | The Channel has been disposed. |