DataConnectionProperties.ReadValueFromString Method

Reads a property value from a connection string starting at a specified index, converts it to the correct type, and updates the index to point to a position following the property name.

Namespace:  Microsoft.VisualStudio.Data
Assembly:  Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)

Syntax

Protected Overridable Function ReadValueFromString ( _
    propertyName As String, _
    connectionString As String, _
    ByRef index As Integer _
) As Object

Dim propertyName As String
Dim connectionString As String
Dim index As Integer
Dim returnValue As Object

returnValue = Me.ReadValueFromString(propertyName, _
    connectionString, index)

protected virtual Object ReadValueFromString(
    string propertyName,
    string connectionString,
    ref int index
)

protected:
virtual Object^ ReadValueFromString(
    String^ propertyName, 
    String^ connectionString, 
    int% index
)

protected function ReadValueFromString(
    propertyName : String, 
    connectionString : String, 
    index : int
) : Object

Parameters

• propertyName
  Type: System.String

  The name of the property for which a value is being read.

• connectionString
  Type: System.String

  The connection string from which the value should be read.

• index
  Type: System.Int32%

  Index into the connection string from which to start reading the value.

Return Value

Type: System.Object

Returns a substring of the connectionString parameter representing the property value between the input starting index and the end of the property name, converted to the correct type.

Exceptions

Remarks

The base implementation of the Parse method calls this method while parsing the input connection string. It uses the index parameter to track the current location in the string and relies on this method and the ReadNameFromString method to update the index appropriately.

The base implementation does the following:

1. It identifies values that are not enclosed in quotation marks, or that are enclosed in either single or double quotation marks;

2. it then reads until the first occurrence of a property entry separator character that is not enclosed in any kind of quotation mark;

3. it then unescapes any embedded quotation mark characters; and

4. finally, it attempts to convert the string value into the correct type by retrieving the descriptor of the specified property and using its TypeConverter to convert to the correct type.

Permissions

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

DataConnectionProperties Class

DataConnectionProperties Members

Microsoft.VisualStudio.Data Namespace