Class Utilities (1.68.0)

public static class Utilities

A utility class which contains helper methods and extension methods.

Inheritance

object > Utilities

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