KGy SOFT

EnumerableExtensionsTryAddRangeT Method (IEnumerableT, IEnumerableT, Boolean, Boolean)

KGy SOFT Core Libraries Help
Tries to add the specified collection to the target collection.

Namespace:  KGySoft.CoreLibraries
Assembly:  KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 5.0.0
Syntax

public static bool TryAddRange<T>(
	this IEnumerable<T> target,
	IEnumerable<T> collection,
	bool checkReadOnly = true,
	bool throwError = true
)

Parameters

target
Type: System.Collections.GenericIEnumerableT
The target collection.
collection
Type: System.Collections.GenericIEnumerableT
The collection to add to the target.
checkReadOnly (Optional)
Type: SystemBoolean
 to return  if the target collection is read-only;  to attempt adding the collection without checking the read-only state. This parameter is optional.
Default value: .
throwError (Optional)
Type: SystemBoolean
 to forward any exception thrown by a found add method;  to suppress the exceptions thrown by the found add method and return  on failure. This parameter is optional.
Default value: .

Type Parameters

T
The type of the elements in the collections.

Return Value

Type: Boolean
, if the whole collection could be added to target; otherwise, .

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerableT. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Remarks

The specified collection can be added to the target collection if that is either an ICollectionT, IProducerConsumerCollectionT or IList implementation.

If target is neither a ListT nor an ISupportsRangeCollectionT implementation, then the elements of collection will only be added one by one.

See Also

Reference