Constructors
GH_LooseChunk
#Create a new loose chunk. A loose chunk does not have an owner archive and thus cannot store runtime messages.
Fields
m_archive
protected GH_Archive m_archive
Pointer to the archive that owns the Root of the tree this chunk belongs to.
m_chunks
Dictionary of sub-chunks contained within this chunk.
m_comments
List of text comments. This list is automatically instantiated once the first comment is added.
m_index
protected int m_index
Index of this chunk. This field is set only once, during construction. A negative index indicates no index qualifier has been set.
m_items
The list of nodes contained within this chunk.
Properties
Archive
Gets a pointer to the archive that owns the Root of the tree this chunk belongs to.
Implements: Archive
ArchiveLocation
Gets a string representing the URI with which the archive is associated. The location may be a null string.
Implements: ArchiveLocation
ChunkCount
Gets the number of child chunks contained in this chunk. The set of all child chunks is referred to as a 'litter'.
Implements: ChunkCount
Chunks
Gets a pointer to the internal list of child chunks. Do not access this list unless you know what you are doing.
Implements: Chunks
HasComments
Gets a value that indicates whether or not comments have been stored in this chunk.
HasIndex
Gets the index existence implication. The item is considered to have an index qualifier if the index value is larger than or equal to zero.
HasName
Gets the name validity of this item. The item is considered to have an invalid name if string.IsNullOrEmpty(name)
Index
Gets the index of this chunk. The index is set by the owner of this chunk. Indices smaller than zero imply no index has been set. The combination of name+index is always unique among a set of chunks in the same litter.
Implements: Index
Implements: ItemCount
Items
Gets a pointer to the internal list of items. Do not access this list unless you know what you are doing.
Implements: Items
Name
Gets the name of this chunk. The name is set by the owner of this chunk. Names must be at least 1 character long. The combination of name+index is always unique among a set of chunks in a single litter.
Implements: Name
Methods
AddComment
Adds a text comment to this chunk. Comments are serialized only if the output flavour is a human readable format. Comments are never deserialized, they are purely for the benefit of the humans reading the file data.
Parameters:
| comment_text (string) | The content of the comment, text might be altered if it contains invalid characters for a chosen format flavour. |
Exceptions:
| ArgumentNullException | Thrown if the content text is either null or empty. |
Implements: AddComment
AddMessage
Log a new message with the top-level archive. Messages are collected during read/write operations, and can be displayed to the user upon completion using GH_Archive.ShowMessageLog().
Parameters:
| m (string) | Message text. |
| t (GH_Message_Type) | Message type. |
Exceptions:
| ArgumentNullException | Thrown if message text is null or empty. |
Implements: AddMessage
ChunkExists
Checks whether a chunk with the specified name and index exists in the litter. Only chunks with index qualifiers are considered. Name comparisons are not case-sensitive.
Parameters:
| name (string) | Name of chunk to test for. |
| index (int) | Index of chunk to test for. If less than zero, ChunkExists(string name) is called instead. |
Returns: True if a chunk with the specified name and index exists, otherwise false.
Implements: ChunkExists
ChunkExists
Checks whether a chunk with the specified name exists in the litter. Only chunks without index qualifiers are considered. Name comparisons are not case-sensitive.
Parameters:
| name (string) | Name of chunk to test for. |
Returns: True if a chunk with the specified name exists, otherwise false.
Implements: ChunkExists
CopyValuesFromChunk
Copy all values and sub-chunks from another chunk.
Parameters:
| other (GH_Chunk) |
CopyValuesToChunk
Copy all values and sub-chunks in this chunk to another chunk which does not point to the same archive.
CreateChunk
Create a new child chunk with the specified name and index qualifier. If another chunk already exists with similar properties, an exception will be thrown.
Returns: The newly created child chunk.
Exceptions:
| ArgumentException | Thrown if the name+index coordinte is already occupied by another chunk. |
Implements: CreateChunk
CreateChunk
Create a new child chunk with the specified name and without an index qualifier. If another chunk already exists with similar properties, an exception will be thrown.
Parameters:
| chunk_name (string) | Name of new child. |
Returns: The newly created child chunk.
Exceptions:
| ArgumentException | Thrown if the name+index coordinte is already occupied by another chunk. |
Implements: CreateChunk
Deserialize_Binary
#Deserializes a byte array.
Parameters:
| content (byte[]) | Byte array to deserialize. |
Returns: True on success, false on failure.
Deserialize_Xml
#Deserializes an Xml string.
Parameters:
| xml_content (string) | Xml to deserialize. |
Returns: True on success, false on failure.
FindChunk
Finds the first chunk in the list that matches the given name and index. Only chunks with index qualifiers are considered.
FindChunk
Finds the first chunk in the litter that matches the given name. Only chunks without index qualifiers are considered.
FindItem
Finds the first item that matches the given name and index. Only items with index qualifiers are considered. Name comparisons are not case-sensitive.
FindItem
Finds the first item that matches the given name. Only items without index qualifiers are considered. Name comparisons are not case-sensitive.
GetBoolean
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetBoolean
GetBoolean
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetBoolean
GetBoundingBox
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetBoundingBox
GetBoundingBox
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetBoundingBox
GetByte
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetByte
GetByte
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetByte
GetByteArray
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetByteArray
GetByteArray
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetByteArray
GetDate
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDate
GetDate
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDate
GetDecimal
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDecimal
GetDecimal
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDecimal
GetDouble
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDouble
GetDouble
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDouble
GetDoubleArray
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDoubleArray
GetDoubleArray
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDoubleArray
GetDrawingBitmap
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingBitmap
GetDrawingBitmap
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingBitmap
GetDrawingColor
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingColor
GetDrawingColor
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingColor
GetDrawingPoint
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingPoint
GetDrawingPoint
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingPoint
GetDrawingPointF
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingPointF
GetDrawingPointF
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingPointF
GetDrawingRectangle
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingRectangle
GetDrawingRectangle
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingRectangle
GetDrawingRectangleF
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingRectangleF
GetDrawingRectangleF
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingRectangleF
GetDrawingSize
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingSize
GetDrawingSize
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingSize
GetDrawingSizeF
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetDrawingSizeF
GetDrawingSizeF
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetDrawingSizeF
GetGuid
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetGuid
GetGuid
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetGuid
GetInt32
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetInt32
GetInt32
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetInt32
GetInt64
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetInt64
GetInt64
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetInt64
GetInterval1D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetInterval1D
GetInterval1D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetInterval1D
GetInterval2D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetInterval2D
GetInterval2D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetInterval2D
GetLine
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetLine
GetLine
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetLine
GetPath
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| basePath (string) | Base path for relative path resolution. |
Returns: An array of path strings. If the resolved relative path is different from the stored absolute path, an array of two strings will be returned [absolute, relative].
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetPath
GetPath
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| basePath (string) | Base path for relative path resolution. |
Returns: An array of path strings. If the resolved relative path is different from the stored absolute path, an array of two strings will be returned [absolute, relative].
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetPath
GetPlane
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetPlane
GetPlane
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetPlane
GetPoint2D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetPoint2D
GetPoint2D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetPoint2D
GetPoint3D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetPoint3D
GetPoint3D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetPoint3D
GetPoint4D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetPoint4D
GetPoint4D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetPoint4D
GetSingle
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetSingle
GetSingle
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetSingle
GetString
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetString
GetString
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetString
GetVersion
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name and index does not exist. |
Implements: GetVersion
GetVersion
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
Returns: The inner value of the item.
Exceptions:
| OverflowException | Thrown if the type conversion fails. |
| InvalidCastException | Thrown if the type conversion is invalid. |
| NullReferenceException | Thrown if the item with the specified name does not exist. |
Implements: GetVersion
ItemExists
Checks whether an item with the specified name and index exists. Only items with index qualifiers are considered. Name comparisons are not case-sensitive.
Parameters:
| name (string) | Name of item to test for. |
| index (int) | Index of item to test for. If index is less than zero, then ItemExists(string name) is called instead. |
Returns: True if an item with the specified name and index exists, otherwise false.
Implements: ItemExists
ItemExists
Gets the occupancy for a specific item name. Only items without index qualifiers are considered.
Parameters:
| name (string) | Name of item to check for. |
Returns: True if an item with a similar name already exists, false if not.
Implements: ItemExists
Parameters:
| reader (BinaryReader) | The Binary reader to use, cannot be null. |
Implements: Read
Parameters:
| chunk (GH_IChunk) | Chunk to remove. |
Returns: True is chunk was removed, false if chunk is not part of this litter.
Exceptions:
| ArgumentNullException | Thrown if chunk is a null reference. |
Implements: RemoveChunk
RemoveChunk
Remove the first chunk with a matching name and index. Only chunks with index qualifiers are considered. Name comparisons are not case-sensitive.
Returns: True is chunk was removed, false if no matching chunk could be found.
Implements: RemoveChunk
RemoveChunk
Remove the first chunk with a matching name. Only chunks without index qualifiers are considered. Name comparisons are not case-sensitive.
Parameters:
| chunk_name (string) | Name of chunk to remove. |
Returns: True is chunk was removed, false if no matching chunk could be found.
Implements: RemoveChunk
RemoveItem
Remove an indexed item from this chunk.
Returns: True on success, false on failure.
Implements: RemoveItem
Parameters:
| itemName (string) | Name of item. |
Returns: True on success, false on failure.
Implements: RemoveItem
Serialize_Binary
#Serializes the data tree into a byte array.
Returns: An array of bytes representing the Loose chunk.
Example:This sample shows how to create a new loose chunk and serialize some values.
public byte[] CreateBinary(string archive_name, string[] item_names, int[] item_values)
{
GH_LooseChunk chunk = new GH_LooseChunk(archive_name);
for (int i = 0; i < item_names.Length; i++)
{
chunk.SetInt32(item_names[i], i, item_values[i]);
}
return chunk.Serialize_Binary();
}Serialize_Xml
#Serializes the data tree into an Xml string.
Returns: A string containing the Xml content.
Example:This sample shows how to create a new loose chunk and serialize some values.
public string CreateXML(string archive_name, string[] item_names, int[] item_values)
{
GH_LooseChunk chunk = new GH_LooseChunk(archive_name);
for (int i = 0; i < item_names.Length; i++)
{
chunk.SetInt32(item_names[i], i, item_values[i]);
}
return chunk.Serialize_Xml();
}SetBoolean
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetBoolean
SetBoolean
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (bool) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetBoolean
SetBoundingBox
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_BoundingBox) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetBoundingBox
SetBoundingBox
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_BoundingBox) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetBoundingBox
SetByte
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetByte
SetByte
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (byte) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetByte
SetByteArray
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetByteArray
SetByteArray
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (byte[]) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetByteArray
SetDate
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDate
SetDate
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (DateTime) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDate
SetDecimal
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDecimal
SetDecimal
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (decimal) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDecimal
SetDouble
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDouble
SetDouble
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (double) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDouble
SetDoubleArray
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDoubleArray
SetDoubleArray
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (double[]) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDoubleArray
SetDrawingBitmap
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingBitmap
SetDrawingBitmap
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (Bitmap) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingBitmap
SetDrawingColor
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingColor
SetDrawingColor
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (Color) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingColor
SetDrawingPoint
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (Point) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingPoint
SetDrawingPoint
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingPoint
SetDrawingPointF
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (PointF) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingPointF
SetDrawingPointF
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingPointF
SetDrawingRectangle
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (Rectangle) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingRectangle
SetDrawingRectangle
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingRectangle
SetDrawingRectangleF
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (RectangleF) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingRectangleF
SetDrawingRectangleF
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (RectangleF) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingRectangleF
SetDrawingSize
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (Size) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingSize
SetDrawingSize
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingSize
SetDrawingSizeF
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (SizeF) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetDrawingSizeF
SetDrawingSizeF
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetDrawingSizeF
SetGuid
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetGuid
SetGuid
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (Guid) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetGuid
SetInt32
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (int) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetInt32
SetInt32
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetInt32
SetInt64
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (long) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetInt64
SetInt64
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetInt64
SetInterval1D
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_Interval1D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetInterval1D
SetInterval1D
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Interval1D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetInterval1D
SetInterval2D
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_Interval2D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetInterval2D
SetInterval2D
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Interval2D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetInterval2D
SetLine
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetLine
SetLine
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Line) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetLine
SetPath
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| absolutePath (string) | Absolute path to store. |
| basePath (string) | Base path. This will be used to also store a relative path. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetPath
SetPath
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| absolutePath (string) | Absolute path to store. |
| basePath (string) | Base path. This will be used to also store a relative path. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetPath
SetPlane
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetPlane
SetPlane
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Plane) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetPlane
SetPoint2D
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_Point2D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetPoint2D
SetPoint2D
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Point2D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetPoint2D
SetPoint3D
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_Point3D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetPoint3D
SetPoint3D
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Point3D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetPoint3D
SetPoint4D
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_Point4D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetPoint4D
SetPoint4D
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Point4D) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetPoint4D
SetSingle
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetSingle
SetSingle
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (float) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetSingle
SetString
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (string) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetString
SetString
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetString
SetVersion
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_value (GH_Version) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetVersion
SetVersion
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| item_value (GH_Version) | Value of item to add. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetVersion
SetVersion
Add a new data item to this chunk. The combination of name and index must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| item_index (int) | Index of item to add. |
| major (int) | Major component of Version structure. |
| minor (int) | Minor component of Version structure. |
| revision (int) | Revision component of Version structure. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name and index already exists. |
Implements: SetVersion
SetVersion
Add a new data item to this chunk. The name must be unique or an exception will be thrown.
Parameters:
| item_name (string) | Name of item to add. |
| major (int) | Major component of Version structure. |
| minor (int) | Minor component of Version structure. |
| revision (int) | Revision component of Version structure. |
Exceptions:
| InvalidOperationException | Thrown if another item with the same name already exists. |
Implements: SetVersion
TryGetBoolean
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref bool) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetBoolean
TryGetBoolean
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetBoolean
TryGetBoundingBox
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_BoundingBox) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetBoundingBox
TryGetBoundingBox
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_BoundingBox) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetBoundingBox
TryGetByte
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref byte) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetByte
TryGetByte
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetByte
TryGetDate
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref DateTime) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDate
TryGetDate
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDate
TryGetDecimal
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref decimal) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDecimal
TryGetDecimal
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDecimal
TryGetDouble
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref double) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDouble
TryGetDouble
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDouble
TryGetDrawingColor
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref Color) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingColor
TryGetDrawingColor
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDrawingColor
TryGetDrawingPoint
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref Point) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingPoint
TryGetDrawingPoint
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDrawingPoint
TryGetDrawingPointF
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref PointF) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingPointF
TryGetDrawingPointF
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDrawingPointF
TryGetDrawingRectangle
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref Rectangle) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingRectangle
TryGetDrawingRectangle
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDrawingRectangle
TryGetDrawingRectangleF
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref RectangleF) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingRectangleF
TryGetDrawingRectangleF
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref RectangleF) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingRectangleF
TryGetDrawingSize
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref Size) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingSize
TryGetDrawingSize
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDrawingSize
TryGetDrawingSizeF
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref SizeF) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetDrawingSizeF
TryGetDrawingSizeF
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetDrawingSizeF
TryGetGuid
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref Guid) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetGuid
TryGetGuid
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetGuid
TryGetInt32
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref int) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetInt32
TryGetInt32
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetInt32
TryGetInt64
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref long) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetInt64
TryGetInt64
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetInt64
TryGetInterval1D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Interval1D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetInterval1D
TryGetInterval1D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_Interval1D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetInterval1D
TryGetInterval2D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Interval2D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetInterval2D
TryGetInterval2D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_Interval2D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetInterval2D
TryGetLine
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Line) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetLine
TryGetLine
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetLine
TryGetPlane
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Plane) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPlane
TryGetPlane
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetPlane
TryGetPoint2D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Point2D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPoint2D
TryGetPoint2D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_Point2D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPoint2D
TryGetPoint3D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Point3D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPoint3D
TryGetPoint3D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_Point3D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPoint3D
TryGetPoint4D
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Point4D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPoint4D
TryGetPoint4D
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_Point4D) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetPoint4D
TryGetSingle
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref float) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetSingle
TryGetSingle
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetSingle
TryGetString
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref string) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetString
TryGetString
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Returns: True if the value was set.
Implements: TryGetString
TryGetVersion
Gets the value of the item with the specified name and index. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| item_index (int) | Index of item to retrieve. |
| value (ref GH_Version) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetVersion
TryGetVersion
Gets the value of the item with the specified name. Name comparison is not case-sensitive.
Parameters:
| item_name (string) | Name of item to retrieve. |
| value (ref GH_Version) | Target of assignment. |
Returns: True if the value was set.
Implements: TryGetVersion
Write
Write this chunk and all child chunks to a binary stream.
Parameters:
| writer (BinaryWriter) | The Binary writer to use, cannot be null. |
Exceptions:
| MemberAccessException | Thrown if the name of this chunk is either null or empty. |
Implements: Write
Parameters:
| writer (XmlWriter) | Xml writer used for serialization. |
Exceptions:
| MemberAccessException | Thrown if |
Implements: Write