IProducerConsumerCollection<T> Interfaccia

Definizione

Spazio dei nomi:: System.Collections.Concurrent

Assembly:: mscorlib.dll, System.Collections.Concurrent.dll

Assembly:: mscorlib.dll

Assembly:: System.Collections.Concurrent.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce i metodi per modificare le raccolte thread-safe destinate all'utilizzo di producer/consumer. Questa interfaccia fornisce una rappresentazione unificata per le raccolte producer/consumer in modo che astrazioni di livello superiore, ad BlockingCollection<T> esempio, possano usare la raccolta come meccanismo di archiviazione sottostante.

generic <typename T>
public interface class IProducerConsumerCollection : System::Collections::Generic::IEnumerable<T>, System::Collections::ICollection

public interface IProducerConsumerCollection<T> : System.Collections.Generic.IEnumerable<T>, System.Collections.ICollection

type IProducerConsumerCollection<'T> = interface
    interface seq<'T>
    interface IEnumerable
    interface ICollection

type IProducerConsumerCollection<'T> = interface
    interface seq<'T>
    interface ICollection
    interface IEnumerable

Public Interface IProducerConsumerCollection(Of T)
Implements ICollection, IEnumerable(Of T)

Parametri di tipo

T

Specifica il tipo di elementi nella raccolta.

Derivato: System.Collections.Concurrent.ConcurrentBag<T>

System.Collections.Concurrent.ConcurrentQueue<T>

System.Collections.Concurrent.ConcurrentStack<T>

Implementazioni: IEnumerable<T> ICollection IEnumerable

Esempio

Nell'esempio seguente viene illustrata una struttura di dati dello stack che implementa System.Collections.Concurrent.IProducerConsumerCollection<T>.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Collections.Concurrent;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;

// Sample implementation of IProducerConsumerCollection(T)
// -- in this case, a thread-safe stack.
public class SafeStack<T> : IProducerConsumerCollection<T>
{
    // Used for enforcing thread-safety
    private object m_lockObject = new object();

    // We'll use a regular old Stack for our core operations
    private Stack<T> m_sequentialStack = null;

    //
    // Constructors
    //
    public SafeStack()
    {
        m_sequentialStack = new Stack<T>();
    }

    public SafeStack(IEnumerable<T> collection)
    {
        m_sequentialStack = new Stack<T>(collection);
    }

    //
    // Safe Push/Pop support
    //
    public void Push(T item)
    {
        lock (m_lockObject) m_sequentialStack.Push(item);
    }

    public bool TryPop(out T item)
    {
        bool rval = true;
        lock (m_lockObject)
        {
            if (m_sequentialStack.Count == 0) { item = default(T); rval = false; }
            else
            {
                item = m_sequentialStack.Pop();
            }
        }
        return rval;
    }

    //
    // IProducerConsumerCollection(T) support
    //
    public bool TryTake(out T item)
    {
        return TryPop(out item);
    }

    public bool TryAdd(T item)
    {
        Push(item);
        return true; // Push doesn't fail
    }

    public T[] ToArray()
    {
        T[] rval = null;
        lock (m_lockObject) rval = m_sequentialStack.ToArray();
        return rval;
    }

    public void CopyTo(T[] array, int index)
    {
        lock (m_lockObject) m_sequentialStack.CopyTo(array, index);
    }

    //
    // Support for IEnumerable(T)
    //
    public IEnumerator<T> GetEnumerator()
    {
        // The performance here will be unfortunate for large stacks,
        // but thread-safety is effectively implemented.
        Stack<T> stackCopy = null;
        lock (m_lockObject) stackCopy = new Stack<T>(m_sequentialStack);
        return stackCopy.GetEnumerator();
    }

    //
    // Support for IEnumerable
    //
    IEnumerator IEnumerable.GetEnumerator()
    {
        return ((IEnumerable<T>)this).GetEnumerator();
    }

    //
    // Support for ICollection
    //
    public bool IsSynchronized
    {
        get { return true; }
    }

    public object SyncRoot
    {
        get { return m_lockObject; }
    }

    public int Count
    {
        get { return m_sequentialStack.Count; }
    }

    public void CopyTo(Array array, int index)
    {
        lock (m_lockObject) ((ICollection)m_sequentialStack).CopyTo(array, index);
    }
}

public class Program
{
    static void Main()
    {
        TestSafeStack();

        // Keep the console window open in debug mode.
        Console.WriteLine("Press any key to exit.");
        Console.ReadKey();
    }

    // Test our implementation of IProducerConsumerCollection(T)
    // Demonstrates:
    //      IPCC(T).TryAdd()
    //      IPCC(T).TryTake()
    //      IPCC(T).CopyTo()
    static void TestSafeStack()
    {
        SafeStack<int> stack = new SafeStack<int>();
        IProducerConsumerCollection<int> ipcc = (IProducerConsumerCollection<int>)stack;

        // Test Push()/TryAdd()
        stack.Push(10); Console.WriteLine("Pushed 10");
        ipcc.TryAdd(20); Console.WriteLine("IPCC.TryAdded 20");
        stack.Push(15); Console.WriteLine("Pushed 15");

        int[] testArray = new int[3];

        // Try CopyTo() within boundaries
        try
        {
            ipcc.CopyTo(testArray, 0);
            Console.WriteLine("CopyTo() within boundaries worked, as expected");
        }
        catch (Exception e)
        {
            Console.WriteLine("CopyTo() within boundaries unexpectedly threw an exception: {0}", e.Message);
        }

        // Try CopyTo() that overflows
        try
        {
            ipcc.CopyTo(testArray, 1);
            Console.WriteLine("CopyTo() with index overflow worked, and it SHOULD NOT HAVE");
        }
        catch (Exception e)
        {
            Console.WriteLine("CopyTo() with index overflow threw an exception, as expected: {0}", e.Message);
        }

        // Test enumeration
        Console.Write("Enumeration (should be three items): ");
        foreach (int item in stack) Console.Write("{0} ", item);
        Console.WriteLine("");

        // Test TryPop()
        int popped = 0;
        if (stack.TryPop(out popped))
        {
            Console.WriteLine("Successfully popped {0}", popped);
        }
        else
        {
            Console.WriteLine("FAILED to pop!!");
        }

        // Test Count
        Console.WriteLine("stack count is {0}, should be 2", stack.Count);

        // Test TryTake()
        if (ipcc.TryTake(out popped))
        {
            Console.WriteLine("Successfully IPCC-TryTaked {0}", popped);
        }
        else
        {
            Console.WriteLine("FAILED to IPCC.TryTake!!");
        }
    }
}

Imports System.Collections.Concurrent

Module IProdCon
    ' Sample implementation of IProducerConsumerCollection(T) -- in this case,
    ' a thread-safe stack.
    Public Class SafeStack(Of T)
        Implements IProducerConsumerCollection(Of T)

        ' Used for enforcing thread-safety
        Private m_lockObject As New Object()

        ' We'll use a regular old Stack for our core operations
        Private m_sequentialStack As Stack(Of T) = Nothing

        '
        ' Constructors
        '
        Public Sub New()
            m_sequentialStack = New Stack(Of T)()
        End Sub

        Public Sub New(ByVal collection As IEnumerable(Of T))
            m_sequentialStack = New Stack(Of T)(collection)
        End Sub

        '
        ' Safe Push/Pop support
        '
        Public Sub Push(ByVal item As T)
            SyncLock m_lockObject
                m_sequentialStack.Push(item)
            End SyncLock
        End Sub

        Public Function TryPop(ByRef item As T) As Boolean
            Dim rval As Boolean = True
            SyncLock m_lockObject
                If m_sequentialStack.Count = 0 Then
                    item = Nothing
                    rval = False
                Else
                    item = m_sequentialStack.Pop()
                End If
            End SyncLock
            Return rval
        End Function

        '
        ' IProducerConsumerCollection(T) support
        '
        Public Function TryTake(ByRef item As T) As Boolean Implements IProducerConsumerCollection(Of T).TryTake
            Return TryPop(item)
        End Function

        Public Function TryAdd(ByVal item As T) As Boolean Implements IProducerConsumerCollection(Of T).TryAdd
            Push(item)
            ' Push doesn't fail
            Return True
        End Function

        Public Function ToArray() As T() Implements IProducerConsumerCollection(Of T).ToArray
            Dim rval As T() = Nothing
            SyncLock m_lockObject
                rval = m_sequentialStack.ToArray()
            End SyncLock
            Return rval
        End Function

        Public Sub CopyTo(ByVal array As T(), ByVal index As Integer) Implements IProducerConsumerCollection(Of T).CopyTo
            SyncLock m_lockObject
                m_sequentialStack.CopyTo(array, index)
            End SyncLock
        End Sub



        '
        ' Support for IEnumerable(T)
        '
        Public Function GetEnumerator() As IEnumerator(Of T) Implements IEnumerable(Of T).GetEnumerator
            ' The performance here will be unfortunate for large stacks,
            ' but thread-safety is effectively implemented.
            Dim stackCopy As Stack(Of T) = Nothing
            SyncLock m_lockObject
                stackCopy = New Stack(Of T)(m_sequentialStack)
            End SyncLock
            Return stackCopy.GetEnumerator()
        End Function


        '
        ' Support for IEnumerable
        '
        Private Function GetEnumerator2() As IEnumerator Implements IEnumerable.GetEnumerator
            Return DirectCast(Me, IEnumerable(Of T)).GetEnumerator()
        End Function

        ' 
        ' Support for ICollection
        '
        Public ReadOnly Property IsSynchronized() As Boolean Implements ICollection.IsSynchronized
            Get
                Return True
            End Get
        End Property

        Public ReadOnly Property SyncRoot() As Object Implements ICollection.SyncRoot
            Get
                Return m_lockObject
            End Get
        End Property

        Public ReadOnly Property Count() As Integer Implements ICollection.Count
            Get
                Return m_sequentialStack.Count
            End Get
        End Property

        Public Sub CopyTo(ByVal array As Array, ByVal index As Integer) Implements ICollection.CopyTo
            SyncLock m_lockObject
                DirectCast(m_sequentialStack, ICollection).CopyTo(array, index)
            End SyncLock
        End Sub
    End Class

    ' Test our implementation of IProducerConsumerCollection(T)
    ' Demonstrates:
    ' IPCC(T).TryAdd()
    ' IPCC(T).TryTake()
    ' IPCC(T).CopyTo()
    Private Sub TestSafeStack()
        Dim stack As New SafeStack(Of Integer)()
        Dim ipcc As IProducerConsumerCollection(Of Integer) = DirectCast(stack, IProducerConsumerCollection(Of Integer))

        ' Test Push()/TryAdd()
        stack.Push(10)
        Console.WriteLine("Pushed 10")
        ipcc.TryAdd(20)
        Console.WriteLine("IPCC.TryAdded 20")
        stack.Push(15)
        Console.WriteLine("Pushed 15")

        Dim testArray As Integer() = New Integer(2) {}

        ' Try CopyTo() within boundaries
        Try
            ipcc.CopyTo(testArray, 0)
            Console.WriteLine("CopyTo() within boundaries worked, as expected")
        Catch e As Exception
            Console.WriteLine("CopyTo() within boundaries unexpectedly threw an exception: {0}", e.Message)
        End Try

        ' Try CopyTo() that overflows
        Try
            ipcc.CopyTo(testArray, 1)
            Console.WriteLine("CopyTo() with index overflow worked, and it SHOULD NOT HAVE")
        Catch e As Exception
            Console.WriteLine("CopyTo() with index overflow threw an exception, as expected: {0}", e.Message)
        End Try

        ' Test enumeration
        Console.Write("Enumeration (should be three items): ")
        For Each item As Integer In stack
            Console.Write("{0} ", item)
        Next
        Console.WriteLine("")

        ' Test TryPop()
        Dim popped As Integer = 0
        If stack.TryPop(popped) Then
            Console.WriteLine("Successfully popped {0}", popped)
        Else
            Console.WriteLine("FAILED to pop!!")
        End If

        ' Test Count
        Console.WriteLine("stack count is {0}, should be 2", stack.Count)

        ' Test TryTake()
        If ipcc.TryTake(popped) Then
            Console.WriteLine("Successfully IPCC-TryTaked {0}", popped)
        Else
            Console.WriteLine("FAILED to IPCC.TryTake!!")
        End If
    End Sub

    Sub Main()
        TestSafeStack()

        ' Keep the console window open in debug mode
        Console.WriteLine("Press any key to exit.")
        Console.ReadKey()

    End Sub

End Module

Commenti

Per altre informazioni, vedere Thread-Safe Collections and BlockingCollection Overview .For more information, seeThread-Safe Collections and BlockingCollection Overview.

Proprietà

Nome	Descrizione
Count	Ottiene il numero di elementi contenuti in ICollection. (Ereditato da ICollection)
IsSynchronized	Ottiene un valore che indica se l'accesso ICollection a è sincronizzato (thread-safe). (Ereditato da ICollection)
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso al ICollection. (Ereditato da ICollection)

Metodi

Nome	Descrizione
CopyTo(Array, Int32)	Copia gli elementi di in ICollection un Arrayoggetto , a partire da un indice specifico Array . (Ereditato da ICollection)
CopyTo(T[], Int32)	Copia gli elementi di in IProducerConsumerCollection<T> un Arrayoggetto , a partire da un indice specificato.
GetEnumerator()	Restituisce un enumeratore che scorre un insieme. (Ereditato da IEnumerable)
ToArray()	Copia gli elementi contenuti in IProducerConsumerCollection<T> in una nuova matrice.
TryAdd(T)	Tenta di aggiungere un oggetto all'oggetto IProducerConsumerCollection<T>.
TryTake(T)	Tenta di rimuovere e restituire un oggetto da IProducerConsumerCollection<T>.

Metodi di estensione

Nome	Descrizione
Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)	Applica una funzione di enumeratore su una sequenza. Il valore di inizializzazione specificato viene utilizzato come valore dell'accumulatore iniziale e la funzione specificata viene usata per selezionare il valore del risultato.
Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>)	Applica una funzione di enumeratore su una sequenza. Il valore di inizializzazione specificato viene utilizzato come valore dell'caricabatterie iniziale.
Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>)	Applica una funzione di enumeratore su una sequenza.
All<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Determina se tutti gli elementi di una sequenza soddisfano una condizione.
Ancestors<T>(IEnumerable<T>, XName)	Restituisce una raccolta filtrata di elementi che contiene i predecessori di ogni nodo nella raccolta di origine. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.
Ancestors<T>(IEnumerable<T>)	Restituisce una raccolta di elementi che contiene i predecessori di ogni nodo nella raccolta di origine.
Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Determina se un elemento di una sequenza soddisfa una condizione.
Any<TSource>(IEnumerable<TSource>)	Determina se una sequenza contiene elementi.
Append<TSource>(IEnumerable<TSource>, TSource)	Aggiunge un valore alla fine della sequenza.
AsEnumerable<TSource>(IEnumerable<TSource>)	Restituisce l'input tipizzato come oggetto IEnumerable<T>.
AsParallel(IEnumerable)	Abilita la parallelizzazione di una query.
AsParallel<TSource>(IEnumerable<TSource>)	Abilita la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un IEnumerable in un IQueryable.
AsQueryable<TElement>(IEnumerable<TElement>)	Converte un IEnumerable<T> generico in un IQueryable<T>generico.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	Calcola la media di una sequenza di valori Decimal ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	Calcola la media di una sequenza di valori Double ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	Calcola la media di una sequenza di valori Int32 ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	Calcola la media di una sequenza di valori Int64 ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	Calcola la media di una sequenza di valori nullable Decimal ottenuti richiamando una funzione di trasformazione su ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	Calcola la media di una sequenza di valori nullable Double ottenuti richiamando una funzione di trasformazione su ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	Calcola la media di una sequenza di valori nullable Int32 ottenuti richiamando una funzione di trasformazione su ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	Calcola la media di una sequenza di valori nullable Int64 ottenuti richiamando una funzione di trasformazione su ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	Calcola la media di una sequenza di valori nullable Single ottenuti richiamando una funzione di trasformazione su ogni elemento della sequenza di input.
Average<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	Calcola la media di una sequenza di valori Single ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un IEnumerable al tipo specificato.
Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Concatena due sequenze.
Contains<TSource>(IEnumerable<TSource>, TSource, IEqualityComparer<TSource>)	Determina se una sequenza contiene un elemento specificato utilizzando un IEqualityComparer<T>specificato.
Contains<TSource>(IEnumerable<TSource>, TSource)	Determina se una sequenza contiene un elemento specificato utilizzando l'operatore di confronto di uguaglianza predefinito.
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)	Copia DataRow oggetti nel DataTablespecificato, dato un oggetto IEnumerable<T> di input in cui il parametro generico `T` è DataRow.
CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)	Copia DataRow oggetti nel DataTablespecificato, dato un oggetto IEnumerable<T> di input in cui il parametro generico `T` è DataRow.
CopyToDataTable<T>(IEnumerable<T>)	Restituisce un DataTable che contiene copie degli oggetti DataRow, dato un oggetto IEnumerable<T> di input in cui il parametro generico `T` è DataRow.
Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce un numero che rappresenta il numero di elementi nella sequenza specificata che soddisfano una condizione.
Count<TSource>(IEnumerable<TSource>)	Restituisce il numero di elementi in una sequenza.
DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)	Restituisce gli elementi della sequenza specificata o il valore specificato in una raccolta singleton se la sequenza è vuota.
DefaultIfEmpty<TSource>(IEnumerable<TSource>)	Restituisce gli elementi della sequenza specificata o il valore predefinito del parametro di tipo in un insieme singleton se la sequenza è vuota.
DescendantNodes<T>(IEnumerable<T>)	Restituisce una raccolta dei nodi discendenti di ogni documento e elemento nella raccolta di origine.
Descendants<T>(IEnumerable<T>, XName)	Restituisce una raccolta filtrata di elementi che contiene gli elementi discendenti di ogni elemento e documento nella raccolta di origine. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.
Descendants<T>(IEnumerable<T>)	Restituisce una raccolta di elementi che contiene gli elementi discendenti di ogni elemento e documento nella raccolta di origine.
Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Restituisce elementi distinti da una sequenza utilizzando un IEqualityComparer<T> specificato per confrontare i valori.
Distinct<TSource>(IEnumerable<TSource>)	Restituisce elementi distinti da una sequenza utilizzando l'operatore di confronto di uguaglianza predefinito per confrontare i valori.
ElementAt<TSource>(IEnumerable<TSource>, Int32)	Restituisce l'elemento in corrispondenza di un indice specificato in una sequenza.
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)	Restituisce l'elemento in corrispondenza di un indice specificato in una sequenza o un valore predefinito se l'indice non è compreso nell'intervallo.
Elements<T>(IEnumerable<T>, XName)	Restituisce una raccolta filtrata degli elementi figlio di ogni elemento e documento nella raccolta di origine. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.
Elements<T>(IEnumerable<T>)	Restituisce un insieme degli elementi figlio di ogni elemento e documento nella raccolta di origine.
Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produce la differenza di set di due sequenze usando il IEqualityComparer<T> specificato per confrontare i valori.
Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Produce la differenza di set di due sequenze usando l'operatore di confronto di uguaglianza predefinito per confrontare i valori.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce il primo elemento di una sequenza che soddisfa una condizione specificata.
First<TSource>(IEnumerable<TSource>)	Restituisce il primo elemento di una sequenza.
FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce il primo elemento della sequenza che soddisfa una condizione o un valore predefinito se non viene trovato alcun elemento di questo tipo.
FirstOrDefault<TSource>(IEnumerable<TSource>)	Restituisce il primo elemento di una sequenza o un valore predefinito se la sequenza non contiene elementi.
GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>, TResult>, IEqualityComparer<TKey>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata e crea un valore di risultato da ogni gruppo e dalla relativa chiave. I valori chiave vengono confrontati usando un operatore di confronto specificato e gli elementi di ogni gruppo vengono proiettati usando una funzione specificata.
GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata e crea un valore di risultato da ogni gruppo e dalla relativa chiave. Gli elementi di ogni gruppo vengono proiettati usando una funzione specificata.
GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave. Le chiavi vengono confrontate usando un operatore di confronto e gli elementi di ogni gruppo vengono proiettati usando una funzione specificata.
GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata e proietta gli elementi per ogni gruppo usando una funzione specificata.
GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>, IEqualityComparer<TKey>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata e crea un valore di risultato da ogni gruppo e dalla relativa chiave. Le chiavi vengono confrontate usando un operatore di confronto specificato.
GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata e crea un valore di risultato da ogni gruppo e dalla relativa chiave.
GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata e confronta le chiavi usando un operatore di confronto specificato.
GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Raggruppa gli elementi di una sequenza in base a una funzione del selettore di chiave specificata.
GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>, TResult>, IEqualityComparer<TKey>)	Correla gli elementi di due sequenze in base all'uguaglianza delle chiavi e raggruppa i risultati. Viene usato un IEqualityComparer<T> specificato per confrontare le chiavi.
GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>, TResult>)	Correla gli elementi di due sequenze in base all'uguaglianza delle chiavi e raggruppa i risultati. L'operatore di confronto di uguaglianza predefinito viene usato per confrontare le chiavi.
InDocumentOrder<T>(IEnumerable<T>)	Restituisce una raccolta di nodi che contiene tutti i nodi della raccolta di origine, ordinati in base all'ordine dei documenti.
Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produce l'intersezione set di due sequenze utilizzando il IEqualityComparer<T> specificato per confrontare i valori.
Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Produce l'intersezione set di due sequenze usando l'operatore di confronto di uguaglianza predefinito per confrontare i valori.
Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)	Correla gli elementi di due sequenze in base alle chiavi corrispondenti. Viene usato un IEqualityComparer<T> specificato per confrontare le chiavi.
Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)	Correla gli elementi di due sequenze in base alle chiavi corrispondenti. L'operatore di confronto di uguaglianza predefinito viene usato per confrontare le chiavi.
Last<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce l'ultimo elemento di una sequenza che soddisfa una condizione specificata.
Last<TSource>(IEnumerable<TSource>)	Restituisce l'ultimo elemento di una sequenza.
LastOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce l'ultimo elemento di una sequenza che soddisfa una condizione o un valore predefinito se non viene trovato alcun elemento di questo tipo.
LastOrDefault<TSource>(IEnumerable<TSource>)	Restituisce l'ultimo elemento di una sequenza o un valore predefinito se la sequenza non contiene elementi.
LongCount<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce un Int64 che rappresenta il numero di elementi in una sequenza che soddisfano una condizione.
LongCount<TSource>(IEnumerable<TSource>)	Restituisce un Int64 che rappresenta il numero totale di elementi in una sequenza.
Max<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza generica e restituisce il valore massimo risultante.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo Decimal.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo Double.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo Int32.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo Int64.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo nullable Decimal.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo nullable Double.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo nullable Int32.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo nullable Int64.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo nullable Single.
Max<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore massimo Single.
Max<TSource>(IEnumerable<TSource>)	Restituisce il valore massimo in una sequenza generica.
Min<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	Richiama una funzione di trasformazione per ogni elemento di una sequenza generica e restituisce il valore minimo risultante.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore minimo Decimal.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore minimo Double.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore minimo Int32.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore minimo Int64.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	Richiama una funzione di trasformazione per ogni elemento di una sequenza e restituisce il valore minimo nullable Decimal.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	Richiama una funzione di trasformazione per ogni elemento di una sequenza e restituisce il valore minimo nullable Double.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	Richiama una funzione di trasformazione per ogni elemento di una sequenza e restituisce il valore minimo nullable Int32.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	Richiama una funzione di trasformazione per ogni elemento di una sequenza e restituisce il valore minimo nullable Int64.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	Richiama una funzione di trasformazione per ogni elemento di una sequenza e restituisce il valore minimo nullable Single.
Min<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	Richiama una funzione di trasformazione su ogni elemento di una sequenza e restituisce il valore minimo Single.
Min<TSource>(IEnumerable<TSource>)	Restituisce il valore minimo in una sequenza generica.
Nodes<T>(IEnumerable<T>)	Restituisce una raccolta dei nodi figlio di ogni documento e elemento nella raccolta di origine.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un IEnumerable in base a un tipo specificato.
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Ordina gli elementi di una sequenza in ordine crescente usando un operatore di confronto specificato.
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Ordina gli elementi di una sequenza in ordine crescente in base a una chiave.
OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Ordina gli elementi di una sequenza in ordine decrescente usando un operatore di confronto specificato.
OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Ordina gli elementi di una sequenza in ordine decrescente in base a una chiave.
Prepend<TSource>(IEnumerable<TSource>, TSource)	Aggiunge un valore all'inizio della sequenza.
Remove<T>(IEnumerable<T>)	Rimuove ogni nodo nella raccolta di origine dal nodo padre.
Reverse<TSource>(IEnumerable<TSource>)	Inverte l'ordine degli elementi in una sequenza.
Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,TResult>)	Proietta ogni elemento di una sequenza in un nuovo form incorporando l'indice dell'elemento.
Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	Proietta ogni elemento di una sequenza in un nuovo form.
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)	Proietta ogni elemento di una sequenza in un IEnumerable<T>, rende flat le sequenze risultanti in una sequenza e richiama una funzione del selettore di risultati in ogni elemento.
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)	Proietta ogni elemento di una sequenza in un IEnumerable<T>, rende flat le sequenze risultanti in una sequenza e richiama una funzione del selettore di risultati in ogni elemento. L'indice di ogni elemento di origine viene utilizzato nella forma intermedia proiettata di tale elemento.
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)	Proietta ogni elemento di una sequenza in un IEnumerable<T> e rende flat le sequenze risultanti in un'unica sequenza.
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)	Proietta ogni elemento di una sequenza in un IEnumerable<T>e rende flat le sequenze risultanti in una sola sequenza. L'indice di ogni elemento di origine viene utilizzato nella forma proiettata di tale elemento.
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Determina se due sequenze sono uguali confrontando i relativi elementi utilizzando un IEqualityComparer<T>specificato.
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Determina se due sequenze sono uguali confrontando gli elementi usando l'operatore di confronto di uguaglianza predefinito per il tipo.
Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce l'unico elemento di una sequenza che soddisfa una condizione specificata e genera un'eccezione se esiste più di un elemento di questo tipo.
Single<TSource>(IEnumerable<TSource>)	Restituisce l'unico elemento di una sequenza e genera un'eccezione se non è presente esattamente un elemento nella sequenza.
SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce l'unico elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se tale elemento non esiste; questo metodo genera un'eccezione se più di un elemento soddisfa la condizione.
SingleOrDefault<TSource>(IEnumerable<TSource>)	Restituisce l'unico elemento di una sequenza o un valore predefinito se la sequenza è vuota; questo metodo genera un'eccezione se nella sequenza sono presenti più elementi.
Skip<TSource>(IEnumerable<TSource>, Int32)	Ignora un numero specificato di elementi in una sequenza e quindi restituisce gli elementi rimanenti.
SkipLast<TSource>(IEnumerable<TSource>, Int32)	Restituisce una nuova raccolta enumerabile che contiene gli elementi di `source` con gli ultimi `count` elementi della raccolta di origine omessi.
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Ignora gli elementi in una sequenza purché una condizione specificata sia true e quindi restituisca gli elementi rimanenti.
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	Ignora gli elementi in una sequenza purché una condizione specificata sia true e quindi restituisca gli elementi rimanenti. L'indice dell'elemento viene usato nella logica della funzione predicato.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	Calcola la somma della sequenza di Decimal valori ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	Calcola la somma della sequenza di Double valori ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	Calcola la somma della sequenza di Int32 valori ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	Calcola la somma della sequenza di Int64 valori ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	Calcola la somma della sequenza di valori nullable Decimal ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	Calcola la somma della sequenza di valori nullable Double ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	Calcola la somma della sequenza di valori nullable Int32 ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	Calcola la somma della sequenza di valori nullable Int64 ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	Calcola la somma della sequenza di valori nullable Single ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	Calcola la somma della sequenza di Single valori ottenuti richiamando una funzione di trasformazione in ogni elemento della sequenza di input.
Take<TSource>(IEnumerable<TSource>, Int32)	Restituisce un numero specificato di elementi contigui dall'inizio di una sequenza.
TakeLast<TSource>(IEnumerable<TSource>, Int32)	Restituisce una nuova raccolta enumerabile contenente gli ultimi `count` elementi di `source`.
TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Restituisce elementi da una sequenza purché una condizione specificata sia true.
TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	Restituisce elementi da una sequenza purché una condizione specificata sia true. L'indice dell'elemento viene usato nella logica della funzione predicato.
ToArray<TSource>(IEnumerable<TSource>)	Crea una matrice da un IEnumerable<T>.
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Crea un Dictionary<TKey,TValue> da un IEnumerable<T> in base a una funzione del selettore di chiave, a un operatore di confronto e a una funzione del selettore di elementi.
ToDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Crea un Dictionary<TKey,TValue> da un IEnumerable<T> in base ai selettori di chiave e alle funzioni del selettore di elementi specificati.
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Crea un Dictionary<TKey,TValue> da un IEnumerable<T> in base a una funzione del selettore di chiave e a un operatore di confronto dei tasti specificati.
ToDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Crea un Dictionary<TKey,TValue> da un IEnumerable<T> in base a una funzione del selettore di chiave specificata.
ToHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Crea un HashSet<T> da un IEnumerable<T> usando il `comparer` per confrontare le chiavi.
ToHashSet<TSource>(IEnumerable<TSource>)	Crea un HashSet<T> da un IEnumerable<T>.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Crea una matrice non modificabile dalla raccolta specificata.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Enumera e trasforma una sequenza e produce un dizionario non modificabile del relativo contenuto usando gli strumenti di confronto chiave e valore specificati.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Enumera e trasforma una sequenza e produce un dizionario non modificabile del relativo contenuto usando l'operatore di confronto di chiavi specificato.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Enumera e trasforma una sequenza e produce un dizionario non modificabile del relativo contenuto.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Costruisce un dizionario non modificabile in base a una trasformazione di una sequenza.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Costruisce un dizionario non modificabile da una raccolta esistente di elementi, applicando una funzione di trasformazione alle chiavi di origine.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Enumera una sequenza, produce un set di hash non modificabile del relativo contenuto e usa l'operatore di confronto di uguaglianza specificato per il tipo di set.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Enumera una sequenza e produce un set di hash non modificabile del relativo contenuto.
ToImmutableList<TSource>(IEnumerable<TSource>)	Enumera una sequenza e produce un elenco non modificabile del relativo contenuto.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Enumera e trasforma una sequenza e produce un dizionario ordinato non modificabile del relativo contenuto usando gli strumenti di confronto chiave e valore specificati.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Enumera e trasforma una sequenza e produce un dizionario ordinato non modificabile del relativo contenuto usando l'operatore di confronto di chiavi specificato.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Enumera e trasforma una sequenza e produce un dizionario ordinato non modificabile del relativo contenuto.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Enumera una sequenza, produce un set ordinato non modificabile del relativo contenuto e usa l'operatore di confronto specificato.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Enumera una sequenza e produce un set ordinato non modificabile del relativo contenuto.
ToList<TSource>(IEnumerable<TSource>)	Crea un List<T> da un IEnumerable<T>.
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Crea un Lookup<TKey,TElement> da un IEnumerable<T> in base a una funzione del selettore di chiave specificata, un operatore di confronto e una funzione selettore di elementi.
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Crea un Lookup<TKey,TElement> da un IEnumerable<T> in base ai selettori di chiave e alle funzioni del selettore di elementi specificati.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Crea un Lookup<TKey,TElement> da un IEnumerable<T> in base a una funzione del selettore di chiave e a un operatore di confronto dei tasti specificati.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Crea un Lookup<TKey,TElement> da un IEnumerable<T> in base a una funzione del selettore di chiave specificata.
Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produce l'unione set di due sequenze utilizzando un IEqualityComparer<T>specificato.
Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Produce l'unione di set di due sequenze usando l'operatore di confronto di uguaglianza predefinito.
Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Filtra una sequenza di valori in base a un predicato.
Where<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	Filtra una sequenza di valori in base a un predicato. L'indice di ogni elemento viene usato nella logica della funzione predicato.
Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)	Applica una funzione specificata agli elementi corrispondenti di due sequenze, generando una sequenza dei risultati.

Si applica a

Thread safety

Tutte le implementazioni di questa interfaccia devono consentire l'uso simultaneo di tutti i membri di questa interfaccia da più thread.

Vedi anche

Procedura: Aggiungere funzionalità di delimitazione e blocco a una classe di raccolta

Commenti e suggerimenti

Questa pagina è stata utile?