This topic has not yet been rated Rate this topic

HashSet(Of T).ExceptWith Method

.NET Framework 4

Other Versions

Removes all elements in the specified collection from the current HashSet(Of T) object.

Namespace: System.Collections.Generic
Assembly: System.Core (in System.Core.dll)

Syntax

C++

Copy

public void ExceptWith(
	IEnumerable<T> other
)

Parameters

other: Type: System.Collections.Generic.IEnumerable(Of T)
The collection of items to remove from the HashSet(Of T) object.

Implements

ISet(Of T).ExceptWith(IEnumerable(Of T))

Exceptions

Exception	Condition
ArgumentNullException	other is Nothing.

Remarks

The ExceptWith method is the equivalent of mathematical set subtraction.

This method is an O(n) operation, where n is the number of elements in the other parameter.

Examples

The following example creates two HashSet(Of T) collections with overlapping sets of data. The lower range of values is then removed from the larger set using the ExceptWith method.

C++

Copy


static void Main()
{
    HashSet<int> lowNumbers = new HashSet<int>();
    HashSet<int> highNumbers = new HashSet<int>();

    for (int i = 0; i < 6; i++)
    {
        lowNumbers.Add(i);
    }

    for (int i = 3; i < 10; i++)
    {
        highNumbers.Add(i);
    }

    Console.Write("lowNumbers contains {0} elements: ", lowNumbers.Count);
    DisplaySet(lowNumbers);

    Console.Write("highNumbers contains {0} elements: ", highNumbers.Count);
    DisplaySet(highNumbers);

    Console.WriteLine("highNumbers ExceptWith lowNumbers...");
    highNumbers.ExceptWith(lowNumbers);

    Console.Write("highNumbers contains {0} elements: ", highNumbers.Count);
    DisplaySet(highNumbers);



}
/* This example provides output similar to the following:
 * lowNumbers contains 6 elements: { 0 1 2 3 4 5 }
 * highNumbers contains 7 elements: { 3 4 5 6 7 8 9 }
 * highNumbers ExceptWith lowNumbers...
 * highNumbers contains 4 elements: { 6 7 8 9 }
 */

Version Information

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

HashSet(Of T) Class

System.Collections.Generic Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ