StringExtensions Class
Provides utility methods for converting string values to other data types.
Inheritance Hierarchy
System.Object
System.Web.WebPages.StringExtensions
Namespace: System.Web.WebPages
Assembly: System.Web.WebPages (in System.Web.WebPages.dll)
Syntax
'Declaration
<ExtensionAttribute> _
Public NotInheritable Class StringExtensions
'Usage
public static class StringExtensions
[ExtensionAttribute]
public ref class StringExtensions abstract sealed
[<AbstractClassAttribute>]
[<SealedAttribute>]
type StringExtensions = class end
public final class StringExtensions
The StringExtensions type exposes the following members.
Methods
Name | Description | |
---|---|---|
As<TValue>(String) | Converts a string to a strongly typed value of the specified data type. | |
As<TValue>(String, TValue) | Converts a string to the specified data type and specifies a default value. | |
AsBool(String) | Converts a string to a Boolean (true/false) value. | |
AsBool(String, Boolean) | Converts a string to a Boolean (true/false) value and specifies a default value. | |
AsDateTime(String) | Converts a string to a DateTime value. | |
AsDateTime(String, DateTime) | Converts a string to a DateTime value and specifies a default value. | |
AsDecimal(String) | Converts a string to a Decimal number. | |
AsDecimal(String, Decimal) | Converts a string to a Decimal number and specifies a default value. | |
AsFloat(String) | Converts a string to a Single number. | |
AsFloat(String, Single) | Converts a string to a Single number and specifies a default value. | |
AsInt(String) | Converts a string to an integer. | |
AsInt(String, Int32) | Converts a string to an integer and specifies a default value. | |
Is<TValue> | Checks whether a string can be converted to the specified data type. | |
IsBool | Checks whether a string can be converted to the Boolean (true/false) type. | |
IsDateTime | Checks whether a string can be converted to the DateTime type. | |
IsDecimal | Checks whether a string can be converted to the Decimal type. | |
IsEmpty | Checks whether a string value is null reference (Nothing in Visual Basic) or empty. | |
IsFloat | Checks whether a string can be converted to the Single type. | |
IsInt | Checks whether a string can be converted to an integer. |
Top
Remarks
Web pages often accept user input as strings. A typical example is a page that contains an HTML form for user account information. The form might contain fields for entering text information, dates, numbers, true or false values, and currency values. When a user submits the data to a web server, the values are sent over HTTP as strings. When your server code handles the posted data, you often want to convert string values to another data type. For example, it is more effective to compare, sort, and work with dates and numbers programmatically if they are in an appropriate date or numeric data type, instead of being in string format.
The StringExtensions class contains two categories of methods for converting strings to other data types:
The As methods. These method names all begin with As and are based on the As() method. They convert string values to a specified type. For example, the AsInt() method converts a string value of "31" to an actual integer-typed value of 31. Similarly, the AsBool() method converts a string value of "true" to the Boolean-typed value of true.
The Is methods. These method names all begin with Is and are based on the Is<TValue>(String) method. They test whether a string value can be converted to the specified type. For example, the IsBool(String) method returns true if the string value passed to the method is "true" or "false". The IsDateTime(String) method returns true if the string value (such as a date string value of "12/25/2010") passed to the method can be converted to a T:System.DateTime value.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.