Class StringExtension

Namespace

Tharga.Toolkit

Assembly

Tharga.Toolkit.Standard.dll

Extension methods and utilities for string manipulation, random string generation, and Base64 encoding.

public static class StringExtension

Inheritance

object

StringExtension

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Fields

AlphaNumericCharacters

public const string AlphaNumericCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"

Field Value

string

BinaryCharacters

public const string BinaryCharacters = "01"

Field Value

string

ExtendedCharacters

public const string ExtendedCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!#$%()*+,-.:;<=>?@[]^_`{|}~"

Field Value

string

HexCharacters

public const string HexCharacters = "0123456789ABCDEF"

Field Value

string

LowerCaseAlphaNumericCharacters

public const string LowerCaseAlphaNumericCharacters = "abcdefghijklmnopqrstuvwxyz0123456789"

Field Value

string

LowerCaseCharacters

public const string LowerCaseCharacters = "abcdefghijklmnopqrstuvwxyz"

Field Value

string

NumericCharacters

public const string NumericCharacters = "0123456789"

Field Value

string

OctCharacters

public const string OctCharacters = "01234567"

Field Value

string

UpperCaseAlphaNumericCharacters

public const string UpperCaseAlphaNumericCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"

Field Value

string

UpperCaseCharacters

public const string UpperCaseCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"

Field Value

string

UriSafeCharacters

public const string UriSafeCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_"

Field Value

string

Methods

FromBase64(string)

Decodes a Base64 string to its UTF-8 representation. Returns null if the input is null.

public static string FromBase64(this string item)

Parameters

item string

Returns

string

GetRandomString(int, int, string)

Generates a cryptographically random string with length between minLength and maxLength.

public static string GetRandomString(int minLength = 8, int maxLength = 16, string availableCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")

Parameters

minLength int

Minimum length of the generated string.

maxLength int

Maximum length of the generated string.

availableCharacters string

The character set to draw from.

Returns

string

Exceptions

ArgumentException

Thrown when the character set is null or empty.

ArgumentOutOfRangeException

Thrown when the length range is invalid.

IfEmpty(string, string)

Returns a fallback value if the string is null or empty.

public static string IfEmpty(this string item, string value)

Parameters

item string

value string

Returns

string

IsNullOrEmpty(string)

Returns true if the string is null or empty.

public static bool IsNullOrEmpty(this string item)

Parameters

item string

Returns

bool

NullIfEmpty(string)

Returns null if the string is empty; otherwise returns the original string.

public static string NullIfEmpty(this string item)

Parameters

item string

Returns

string

Random(string, int, int)

Returns a random string from provided array.

public static string Random(this string characters, int minLength = 8, int maxLength = 16)

Parameters

characters string

minLength int

maxLength int

Returns

string

RandomString(int, int, string)

[Obsolete("Use GetRandomString instead.")]
public static string RandomString(int minLength = 8, int maxLength = 16, string availableCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")

Parameters

minLength int

maxLength int

availableCharacters string

Returns

string

RandomString(int, string)

Returns a random string of alphanumeric characters given a specific length.

public static string RandomString(this int length, string availableCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")

Parameters

length int

availableCharacters string

Returns

string

ToBase64(string)

Encodes the string to Base64 using UTF-8. Returns null if the input is null.

public static string ToBase64(this string item)

Parameters

item string

Returns

string

Truncate(string, int)

Truncates the string to the specified maximum length.

public static string Truncate(this string item, int maxLength)

Parameters

item string

maxLength int

Returns

string