Class Utilities (1.68.0)

public static class Utilities

A utility class which contains helper methods and extension methods.

Inheritance

object > Utilities

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace

Google.Apis.Util

Assembly

Google.Apis.Core.dll

Methods

CheckArgument<T1, T2>(bool, string, string, T1, T2)

public static void CheckArgument<T1, T2>(bool condition, string paramName, string format, T1 arg0, T2 arg1)

Checks that given argument-based condition is met, throwing an ArgumentException otherwise.

Parameters
Name	Description
`condition`	`bool` The (already evaluated) condition to check.
`paramName`	`string` The name of the parameter whose value is being tested.
`format`	`string` The format string to use to create the exception message if the condition is not met.
`arg0`	`T1` The first argument to the format string.
`arg1`	`T2` The second argument to the format string.

Type Parameters
Name	Description
`T1`
`T2`

CheckEnumValue<T>(T, string)

public static T CheckEnumValue<T>(T value, string paramName) where T : struct

Checks that the given value is in fact defined in the enum used as the type argument of the method.

Parameters
Name	Description
`value`	`T` The value to check.
`paramName`	`string` The name of the parameter whose value is being tested.

Returns
Type	Description
`T`	`value` if it was a defined value

Type Parameter
Name	Description
`T`	The enum type to check the value within.

ConvertToString(object)

public static string ConvertToString(object o)

Tries to convert the specified object to a string. Uses custom type converters if available. Returns null for a null object.

Parameter
Name	Description
`o`	`object`

Returns
Type	Description
`string`

DeserializeForGoogleFormat(string)

public static object DeserializeForGoogleFormat(string rawValue)

Deserializes the given raw value to an object using Instance, as if it were a JSON string value.

Parameter
Name	Description
`rawValue`	`string` The string value to deserialize. May be null, in which case null is returned.

Returns
Type	Description
`object`	The deserialized value.

GetCustomAttribute<T>(MemberInfo)

public static T GetCustomAttribute<T>(this MemberInfo info) where T : Attribute

A Google.Apis utility method for returning the first matching custom attribute (or null) of the specified member.

Parameter
Name	Description
`info`	`MemberInfo`

Returns
Type	Description
`T`

Type Parameter
Name	Description
`T`

GetDateTimeFromString(string)

public static DateTime? GetDateTimeFromString(string raw)

Parses the input string and returns DateTime if the input is a valid representation of a date. Otherwise it returns null.

Parameter
Name	Description
`raw`	`string`

Returns
Type	Description
`DateTime`

GetDateTimeOffsetFromString(string)

public static DateTimeOffset? GetDateTimeOffsetFromString(string raw)

Parses the input string and returns DateTimeOffset if the input is of the format "yyyy-MM-ddTHH:mm:ss.FFFZ" or "yyyy-MM-ddTHH:mm:ssZ". If the input is null, this method returns null. Otherwise, FormatException is thrown.

Parameter
Name	Description
`raw`	`string`

Returns
Type	Description
`DateTimeOffset`

GetEnumStringValue(Enum)

public static string GetEnumStringValue(Enum value)

Returns the defined string value of an Enum. Use for test purposes or in other Google.Apis projects.

Parameter
Name	Description
`value`	`Enum`

Returns
Type	Description
`string`

GetLibraryVersion()

public static string GetLibraryVersion()

Returns the version of the core library.

Returns
Type	Description
`string`

GetStringFromDateTime(DateTime?)

public static string GetStringFromDateTime(DateTime? date)

Returns a string (by RFC3339) form the input DateTime instance.

Parameter
Name	Description
`date`	`DateTime`

Returns
Type	Description
`string`

GetStringFromDateTimeOffset(DateTimeOffset?)

public static string GetStringFromDateTimeOffset(DateTimeOffset? date)

Returns a string from the input DateTimeOffset instance, or null if date is null. The string is always in the format "yyyy-MM-ddTHH:mm:ss.fffZ" or "yyyy-MM-ddTHH:mm:ssZ" - always UTC, always either second or millisecond precision, and always using the invariant culture.

Parameter
Name	Description
`date`	`DateTimeOffset`

Returns
Type	Description
`string`

SerializeForGoogleFormat(object)

public static string SerializeForGoogleFormat(object value)

Serializes the given value using Instance.

Parameter
Name	Description
`value`	`object` The value to serialize. May be null, in which case null is returned.

Returns
Type	Description
`string`	The string representation of the object.

Exceptions
Type	Description
`ArgumentException`	The value does not serialize to a JSON string.

ThrowIfNullOrEmpty(string, string)

public static string ThrowIfNullOrEmpty(this string str, string paramName)

A Google.Apis utility method for throwing an ArgumentNullException if the string is null or empty.

Parameters
Name	Description
`str`	`string`
`paramName`	`string`

Returns
Type	Description
`string`	The original string.

ThrowIfNull<T>(T, string)

public static T ThrowIfNull<T>(this T obj, string paramName)

A Google.Apis utility method for throwing an ArgumentNullException if the object is null.

Parameters
Name	Description
`obj`	`T`
`paramName`	`string`

Returns
Type	Description
`T`

Type Parameter
Name	Description
`T`