Creates a new CHAR Container within this Channel.

Namespace:  IBM.CTG
Assembly:  IBM.CTG.Client (in IBM.CTG.Client.dll) Version: 1.0.0.0

Syntax

C#
public Container CreateContainer(
	string containerName,
	byte[] charData,
	int ccsid
)
Visual Basic (Declaration)
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

ExceptionCondition
IBM.CTG..::.InvalidNameExceptionAn invalid name was specified for the Container.
System..::.ArgumentNullExceptionname is nullNothingnullptra null reference (Nothing in Visual Basic).
System..::.ArgumentOutOfRangeExceptionccsid is set to zero or a negative number.
System..::.NotSupportedExceptionccsid is not a supported CCSID.
IBM.CTG..::.ContainerExistsExceptionA Container with the same name already exists within the Channel.
System..::.ObjectDisposedExceptionThe Channel has been disposed.

See Also