GH_Chunk
ReferencesFull implementation of GH_IChunk, GH_IReader, GH_IWriter, GH_IBinarySupport and GH_IXmlSupport. Instances of this class are usually disguised as one of the interfaces it implements.
Constructors
GH_Chunk
#protected GH_Chunk()
Blank constructor. You typically do not need to create your own Chunks. The GH_Archive class will create top-level chunks and existing chunks can create child chunks.
GH_Chunk
#Constructor. You typically do not need to create your own Chunks. The GH_Archive class will create top-level chunks and existing chunks can create child chunks.
Parameters:
| chunk_archive (GH_Archive) | Owner archive. |
| chunk_name (string) | Name of this chunk. |
| chunk_index (int) | Index of this chunk. |
GH_Chunk
#Constructor. You typically do not need to create your own Chunks. The GH_Archive class will create top-level chunks and existing chunks can create child chunks.
Parameters:
| chunk_archive (GH_Archive) | Owner archive. |
| chunk_name (string) | Name of this chunk. |
GH_Chunk
#Constructor. You typically do not need to create your own Chunks. The GH_Archive class will create top-level chunks and existing chunks can create child chunks.
Parameters:
| chunk_archive (GH_Archive) | Owner archive. |
Fields
m_archive
#protected GH_Archive m_archive
Pointer to the archive that owns the Root of the tree this chunk belongs to.
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.
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
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
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
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
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
InstantiateRoot
#Construct a new instance of GH_Chunk which acts as a Root node. If you must create a chunk from scratch, use this static method to create one.
Parameters:
| owner (GH_Archive) | The archive which owns this chunk. |
Exceptions:
| ArgumentNullException | Thrown when the owner is a null reference. |
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
Read
#Read this chunk and all child chunks from a binary stream.
Parameters:
| reader (BinaryReader) | The Binary reader to use, cannot be null. |
Implements: Read
RemoveChunk
#Remove the specified chunk from the litter.
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
RemoveItem
#Remove an unindexed item from this chunk.
Parameters:
| itemName (string) | Name of item. |
Returns: True on success, false on failure.
Implements: RemoveItem
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
Write
#Serialize this chunk into an Xml stream.
Parameters:
| writer (XmlWriter) | Xml writer used for serialization. |
Exceptions:
| MemberAccessException | Thrown if |
Implements: Write