Class ArchiveRowTypeInfo

This class carries information about one archive entity

Inheritance

System.Object

ArchiveRowTypeInfo

Implements

System.ICloneable

Inherited Members

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

Namespace: SuperOffice.CRM.ArchiveLists

Assembly: SoCore.dll

Syntax

public class ArchiveRowTypeInfo : ICloneable

Constructors

ArchiveRowTypeInfo()

Construct the object, setting nothing.

Declaration

public ArchiveRowTypeInfo()

ArchiveRowTypeInfo(String, String, Boolean)

Construct the object, setting name, display name and isOptional status

Declaration

public ArchiveRowTypeInfo(string name, string displayName, bool isOptional)

Parameters

Type	Name	Description
System.String	name	Programmatic name (it is permissible for multiple providers to offer the same entity!)
System.String	displayName	Display name to be shown to the user, can contain resource tags
Boolean	isOptional	Is this entity optional? If yes, we expect a GUI to be shown somehow, enabling the user to select it or avoid it

ArchiveRowTypeInfo(String, String, String, Boolean, Boolean)

Construct the object, setting name, display name, isOptional status

Declaration

public ArchiveRowTypeInfo(string name, string displayName, string displayTooltip, bool isOptional, bool isDefaultShow)

Parameters

Type	Name	Description
System.String	name	Programmatic name (it is permissible for multiple providers to offer the same entity!)
System.String	displayName	Display name to be shown to the user, can contain resource tags
System.String	displayTooltip	Display tooltip to be shown to the user, can contain resource tags
Boolean	isOptional	Is this entity optional? If yes, we expect a GUI to be shown somehow, enabling the user to select it or avoid it
Boolean	isDefaultShow	Should this entity be chosen by default? If yes, we expect a GUI checkbox to be checked

Fields

HideAsDefault

Constant, for use in constructor instead of the anonymous true/false.

Declaration

public const bool HideAsDefault = false

Field Value

Type	Description
Boolean

Mandatory

Constant value intended for the isOptional parameter of the constructor

Declaration

public const bool Mandatory = false

Field Value

Type	Description
Boolean

Optional

Constant value intended for the isOptional parameter of the constructor

Declaration

public const bool Optional = true

Field Value

Type	Description
Boolean

SetMandatory

Constant, for use in constructor instead of the anonymous true/false.

Declaration

public const bool SetMandatory = false

Field Value

Type	Description
Boolean

SetOptional

Constant, for use in constructor instead of the anonymous true/false.

Declaration

public const bool SetOptional = true

Field Value

Type	Description
Boolean

ShowAsDefault

Constant, for use in constructor instead of the anonymous true/false.

Declaration

public const bool ShowAsDefault = true

Field Value

Type	Description
Boolean

Properties

DefaultShow

Should this entity be shown as default, if it is optional (i.e., should it be selected for showing when an archive is first-ever presented to the user)

Declaration

public bool DefaultShow { get; set; }

Property Value

Type	Description
Boolean

DisplayName

The user-friendly name of the entity, to be reflected in checkboxes in the archive

Declaration

public string DisplayName { get; set; }

Property Value

Type	Description
System.String

DisplayTooltip

User-friendly tooltip for the entity, to be reflected in the checkboxes in the archive

Declaration

public string DisplayTooltip { get; set; }

Property Value

Type	Description
System.String

IsOptional

Can this entity be selected in the GUI (typically through a checkbox with the entity display name in the bottom of the archive). If not, the entity should ALWAYS be requested (this is the default behaviour).

Declaration

public bool IsOptional { get; set; }

Property Value

Type	Description
Boolean

Name

Unique entity identifier

Declaration

public string Name { get; set; }

Property Value

Type	Description
System.String

Methods

Clone()

Declaration

public object Clone()

Returns

Type	Description
System.Object

ToNameArray(ArchiveRowTypeInfo[])

Utility method to convert an array of ArchiveEntityInfo into a string array containing the names only

Declaration

public static string[] ToNameArray(params ArchiveRowTypeInfo[] entityInfos)

Parameters

Type	Name	Description
ArchiveRowTypeInfo[]	entityInfos	Column infos to extract names from

Returns

Type	Description
System.String[]	Array of names, in original order

ToNameArray(List<ArchiveRowTypeInfo>)

Utility method to convert a list of ArchiveEntityInfo into a string array containing the names only

Declaration

public static string[] ToNameArray(List<ArchiveRowTypeInfo> entityInfos)

Parameters

Type	Name	Description
System.Collections.Generic.List<ArchiveRowTypeInfo>	entityInfos	Column infos to extract names from

Returns

Type	Description
System.String[]	Array of names, in original order

ToNameArray(Predicate<ArchiveRowTypeInfo>, ArchiveRowTypeInfo[])

Utility method to conditionally convert an array of ArchiveEntityInfo into a string array containing the names only. The given predicate is applied to each ArchiveEntityInfo to determine if its name should be included in the result.

Declaration

public static string[] ToNameArray(Predicate<ArchiveRowTypeInfo> condition, params ArchiveRowTypeInfo[] entityInfos)

Parameters

Type	Name	Description
System.Predicate<ArchiveRowTypeInfo>	condition	Predicate that takes an ArchiveEntityInfo and returns a bool. A value of true indicates that that particular ArchiveEntityInfo should be included in the result.
ArchiveRowTypeInfo[]	entityInfos	Column infos to test and extract the name from

Returns

Type	Description
System.String[]	Array of names of column infos that were chosen, in original order

ToNameArray(Predicate<ArchiveRowTypeInfo>, List<ArchiveRowTypeInfo>)

Utility method to conditionally convert a list of ArchiveEntityInfo into a string array containing the names only. The given predicate is applied to each ArchiveEntityInfo to determine if its name should be included in the result.

Declaration

public static string[] ToNameArray(Predicate<ArchiveRowTypeInfo> condition, List<ArchiveRowTypeInfo> entityInfos)

Parameters

Type	Name	Description
System.Predicate<ArchiveRowTypeInfo>	condition	Predicate that takes an ArchiveEntityInfo and returns a bool. A value of true indicates that that particular ArchiveEntityInfo should be included in the result.
System.Collections.Generic.List<ArchiveRowTypeInfo>	entityInfos	Column infos to test and extract the name from

Returns

Type	Description
System.String[]	Array of names of column infos that were chosen, in original order

ToNameDictionary(ArchiveRowTypeInfo[])

Utility method to convert an array of ArchiveEntityInfo into a string array containing the names only

Declaration

public static Dictionary<string, ArchiveRowTypeInfo> ToNameDictionary(params ArchiveRowTypeInfo[] entityInfos)

Parameters

Type	Name	Description
ArchiveRowTypeInfo[]	entityInfos	Column infos to extract names from

Returns

Type	Description
System.Collections.Generic.Dictionary<System.String, ArchiveRowTypeInfo>	Array of names, in original order

ToNameDictionary(List<ArchiveRowTypeInfo>)

Utility method to convert a list of ArchiveEntityInfo into a string array containing the names only

Declaration

public static Dictionary<string, ArchiveRowTypeInfo> ToNameDictionary(List<ArchiveRowTypeInfo> entityInfos)

Parameters

Type	Name	Description
System.Collections.Generic.List<ArchiveRowTypeInfo>	entityInfos	Column infos to extract names from

Returns

Type	Description
System.Collections.Generic.Dictionary<System.String, ArchiveRowTypeInfo>	Array of names, in original order

ToNameDictionary(Predicate<ArchiveRowTypeInfo>, ArchiveRowTypeInfo[])

Utility method to conditionally convert an array of ArchiveEntityInfo into a string array containing the names only. The given predicate is applied to each ArchiveEntityInfo to determine if its name should be included in the result.

Declaration

public static Dictionary<string, ArchiveRowTypeInfo> ToNameDictionary(Predicate<ArchiveRowTypeInfo> condition, params ArchiveRowTypeInfo[] entityInfos)

Parameters

Type	Name	Description
System.Predicate<ArchiveRowTypeInfo>	condition	Predicate that takes an ArchiveEntityInfo and returns a bool. A value of true indicates that that particular ArchiveEntityInfo should be included in the result.
ArchiveRowTypeInfo[]	entityInfos	Column infos to test and extract the name from

Returns

Type	Description
System.Collections.Generic.Dictionary<System.String, ArchiveRowTypeInfo>	Array of names of column infos that were chosen, in original order

ToNameDictionary(Predicate<ArchiveRowTypeInfo>, List<ArchiveRowTypeInfo>)

Utility method to conditionally convert a list of ArchiveEntityInfo into a string array containing the names only. The given predicate is applied to each ArchiveEntityInfo to determine if its name should be included in the result.

Declaration

public static Dictionary<string, ArchiveRowTypeInfo> ToNameDictionary(Predicate<ArchiveRowTypeInfo> condition, List<ArchiveRowTypeInfo> entityInfos)

Parameters

Type	Name	Description
System.Predicate<ArchiveRowTypeInfo>	condition	Predicate that takes an ArchiveEntityInfo and returns a bool. A value of true indicates that that particular ArchiveEntityInfo should be included in the result.
System.Collections.Generic.List<ArchiveRowTypeInfo>	entityInfos	Column infos to test and extract the name from

Returns

Type	Description
System.Collections.Generic.Dictionary<System.String, ArchiveRowTypeInfo>	Array of names of column infos that were chosen, in original order

ToString()

Return a string representation, intended for debug display purposes

Declaration

public override string ToString()

Returns

Type	Description
System.String

Overrides

System.Object.ToString()

Implements

System.ICloneable

Extension Methods

EnumUtil.MapEnums<From, To>(From)

ObjectExtensions.AssignByReflection<T>(T, T)

ObjectExtensions.GraphCopy<T>(T)

Converters.MapEnums<From, To>(From)