ConnectionSettings.ThrowIfPropertyNotSet Method (String, String, Boolean)
Throws an exception if the specified connection property is null or, optionally, empty.
Namespace: Microsoft.SqlServer.Management.Common
Assembly: Microsoft.SqlServer.ConnectionInfo (in Microsoft.SqlServer.ConnectionInfo.dll)
Syntax
'Declaration
Protected Function ThrowIfPropertyNotSet ( _
propertyName As String, _
str As String, _
checkEmpty As Boolean _
) As String
'Usage
Dim propertyName As String
Dim str As String
Dim checkEmpty As Boolean
Dim returnValue As String
returnValue = Me.ThrowIfPropertyNotSet(propertyName, _
str, checkEmpty)
protected string ThrowIfPropertyNotSet(
string propertyName,
string str,
bool checkEmpty
)
protected:
String^ ThrowIfPropertyNotSet(
String^ propertyName,
String^ str,
bool checkEmpty
)
member ThrowIfPropertyNotSet :
propertyName:string *
str:string *
checkEmpty:bool -> string
protected function ThrowIfPropertyNotSet(
propertyName : String,
str : String,
checkEmpty : boolean
) : String
Parameters
- propertyName
Type: String
A string that specifies the name of the connection property, such as "Login".
- str
Type: String
A String object that contains the property value.
- checkEmpty
Type: Boolean
True if you want to check the property value for an empty string or null value; false if you want to check only for a null value.
Return Value
Type: String
If the property is not set, this method throws a PropertyNotSetException. Otherwise, this method returns the str parameter value.
Remarks
If you want to throw the exception if the property value is an empty string, set the checkEmpty parameter to true.