Como passar uma matriz para um procedimento armazenado do SQL Server

SQL Server 2008 (ou mais recente)

Primeiro, em seu banco de dados, crie os dois objetos a seguir:

CREATE TYPE dbo.IDList
AS TABLE
(
  ID INT
);
GO

CREATE PROCEDURE dbo.DoSomethingWithEmployees
  @List AS dbo.IDList READONLY
AS
BEGIN
  SET NOCOUNT ON;

  SELECT ID FROM @List; 
END
GO

Agora no seu código C#:

// Obtain your list of ids to send, this is just an example call to a helper utility function
int[] employeeIds = GetEmployeeIds();

DataTable tvp = new DataTable();
tvp.Columns.Add(new DataColumn("ID", typeof(int)));

// populate DataTable from your List here
foreach(var id in employeeIds)
    tvp.Rows.Add(id);

using (conn)
{
    SqlCommand cmd = new SqlCommand("dbo.DoSomethingWithEmployees", conn);
    cmd.CommandType = CommandType.StoredProcedure;
    SqlParameter tvparam = cmd.Parameters.AddWithValue("@List", tvp);
    // these next lines are important to map the C# DataTable object to the correct SQL User Defined Type
    tvparam.SqlDbType = SqlDbType.Structured;
    tvparam.TypeName = "dbo.IDList";
    // execute query, consume results, etc. here
}

SQL Server 2005

Se você estiver usando o SQL Server 2005, eu ainda recomendaria uma função de divisão em XML. Primeiro, crie uma função:

CREATE FUNCTION dbo.SplitInts
(
   @List      VARCHAR(MAX),
   @Delimiter VARCHAR(255)
)
RETURNS TABLE
AS
  RETURN ( SELECT Item = CONVERT(INT, Item) FROM
      ( SELECT Item = x.i.value('(./text())[1]', 'varchar(max)')
        FROM ( SELECT [XML] = CONVERT(XML, '<i>'
        + REPLACE(@List, @Delimiter, '</i><i>') + '</i>').query('.')
          ) AS a CROSS APPLY [XML].nodes('i') AS x(i) ) AS y
      WHERE Item IS NOT NULL
  );
GO

Agora seu procedimento armazenado pode ser apenas:

CREATE PROCEDURE dbo.DoSomethingWithEmployees
  @List VARCHAR(MAX)
AS
BEGIN
  SET NOCOUNT ON;

  SELECT EmployeeID = Item FROM dbo.SplitInts(@List, ','); 
END
GO

E no seu código C# você só precisa passar a lista como '1,2,3,12' ...

Acho que o método de passar por parâmetros com valor de tabela simplifica a capacidade de manutenção de uma solução que o usa e geralmente aumenta o desempenho em comparação com outras implementações, incluindo XML e divisão de strings.

As entradas são claramente definidas (ninguém precisa adivinhar se o delimitador é uma vírgula ou um ponto e vírgula) e não temos dependências de outras funções de processamento que não sejam óbvias sem inspecionar o código do procedimento armazenado.

Em comparação com soluções que envolvem esquema XML definido pelo usuário em vez de UDTs, isso envolve um número semelhante de etapas, mas na minha experiência é um código muito mais simples de gerenciar, manter e ler.

Em muitas soluções, você pode precisar apenas de um ou alguns desses UDTs (Tipos definidos pelo usuário) que você reutiliza para muitos procedimentos armazenados. Assim como neste exemplo, o requisito comum é passar por uma lista de ponteiros de ID, o nome da função descreve qual contexto esses IDs devem representar, o nome do tipo deve ser genérico.