Declaration Syntax| C# | Visual Basic | Visual C++ |
[SerializableAttribute] public sealed class Name
<SerializableAttribute> Public NotInheritable Class Name
[SerializableAttribute] public ref class Name sealed
Members| All Members | Constructors | Methods | Fields | ||
| Icon | Member | Description |
|---|---|---|
 | Name()()()() | Initializes a new instance of the Name class |
| Name(String) |
Constructs a Name from the specified nameString.
|
| Equals(Object) | Compares this Name object to the specified Object.
(Overrides Object.Equals(Object).) |
 | FindName(String) | Returns a reference to a Name object for the specified nameString or
null if a Name does not exist.
|
| FreeGlobalNameTable()()()() |
Purges all entries from the global name table.
|
| GetHashCode()()()() | (Overrides Object.GetHashCode()()()().) |
| GetName(String) | Returns a reference to a Name object for the specified nameString
creating it if it doesn't exist already.
|
| HasName(String) | Returns true if a reference to a Name
object exists for the specified nameString.
|
 | NullName | |
| ToString()()()() | Returns the String this Name object represents.
(Overrides Object.ToString()()()().) |
RemarksThe Name class is an efficient substitute for a string when used as a key, providing constant time comparison and ordering operations. Two Name objects constructed from Strings for which equals() would return true will always compare equally.
This is where possible Name objects should be initialized once and then reused. Creating a Name object from a String involves a search in a container requiring multiple string comparison operations.
Note: Each Name instance refers to an entry in a global static table. Name instances for identical strings will refer to the same data. There is no provision for removing entries from the static table so Name objects should only be used when the set of input strings is bounded.
For example, creating a Name for every possible field name and type in a data model is reasonable (in fact, the API will do this whenever it receives schema information). However, converting sequence numbers on incoming messages to strings and creating a Name from each one of those strings will cause the static table to grow in an unbounded manner.
Thread Safety Inheritance Hierarchy| Object | |
 | Name |
Assembly: Bloomberglp.Blpapi (Module: Bloomberglp.Blpapi.dll) Version: 3.7.4.1