DataSourceAttribute, classe

Article
08/10/2011

Fournit des informations spécifiques à la source de données pour les tests pilotés par les données. Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

System.Object
System.Attribute
Microsoft.VisualStudio.TestTools.UnitTesting.DataSourceAttribute

Espace de noms : Microsoft.VisualStudio.TestTools.UnitTesting
Assembly : Microsoft.VisualStudio.QualityTools.UnitTestFramework (dans Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

Syntaxe

'Déclaration
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False)> _
Public NotInheritable Class DataSourceAttribute _
    Inherits Attribute

[AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple = false)]
public sealed class DataSourceAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Method, AllowMultiple = false)]
public ref class DataSourceAttribute sealed : public Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple = false)>]
type DataSourceAttribute =  
    class
        inherit Attribute
    end

public final class DataSourceAttribute extends Attribute

Le type DataSourceAttribute expose les membres suivants.

Constructeurs

	Nom	Description
	DataSourceAttribute(String)	Initialise une nouvelle instance de la classe DataSourceAttribute.Cette instance sera initialisée avec un fournisseur de données et une chaîne de connexion associés au nom du paramètre.
	DataSourceAttribute(String, String)	Initialise une nouvelle instance de la classe DataSourceAttribute.Cette instance sera initialisée avec une chaîne de connexion et un nom de table.
	DataSourceAttribute(String, String, String, DataAccessMethod)	Initialise une nouvelle instance de la classe DataSourceAttribute.Cette instance sera initialisée avec un fournisseur de données, une chaîne de connexion, une table de données et une méthode d'accès aux données pour accéder à la source de données.

Début

Propriétés

	Nom	Description
	ConnectionString	Obtient une valeur représentant la chaîne de connexion pour la source de données.
	DataAccessMethod	Obtient la méthode utilisée pour accéder à la source de données.
	DataSourceSettingName	Obtient une valeur indiquant le nom du paramètre utilisé pour identifier les informations de connexion de la source de données stockées dans un fichier de configuration.
	ProviderInvariantName	Obtient une valeur représentant le fournisseur de données de la source de données.
	TableName	Obtient une valeur indiquant le nom de la table fournissant les données.
	TypeId	Lors de son implémentation dans une classe dérivée, obtient un identificateur unique pour Attribute. (Hérité de Attribute.)

Début

Méthodes

	Nom	Description
	Equals	Infrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Retourne le code de hachage pour cette instance. (Hérité de Attribute.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	IsDefaultAttribute	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute.)
	Match	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Champs

	Nom	Description
	DefaultDataAccessMethod	Représente la méthode d'accès aux données par défaut.Ce champ est en lecture seule.
	DefaultProviderName	Représente le nom du fournisseur de données par défaut.Ce champ est en lecture seule.

Début

Implémentations d'interface explicite

	Nom	Description
	_Attribute.GetIDsOfNames	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.)
	_Attribute.GetTypeInfo	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute.)
	_Attribute.GetTypeInfoCount	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.)
	_Attribute.Invoke	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.)

Début

Notes

La classe DataSourceAttribute permet de spécifier des informations de source de données pour les tests pilotés par les données de deux manières. La première méthode spécifie des informations par une chaîne de connexion, les informations du fournisseur et le nom de table source passé à DataSourceAttribute.

Exemple de chaîne de connexion :

[DataSource("Provider=SQLOLEDB.1;Data Source=MySource;Integrated] Security=SSPI;Initial Catalog=MyCatalog;Persist Security Info=False", "MyTable")]

La deuxième méthode passe un argument unique à l'attribut qui spécifie le paramètre de configuration se trouvant dans le fichier app.config.

Exemple de paramètre de configuration :

[DataSource("dataSourceNameFromConfigFile")]

Notes

Différents fournisseurs de données n'utilisent pas les mêmes chaînes de connexion. Le nom du fournisseur fait partie de la chaîne de connexion.

Pour plus d'informations sur l'utilisation du fichier app.config pour spécifier une source de données, consultez Procédure pas à pas : utilisation d'un fichier de configuration pour définir une source de données.

Pour plus d'informations sur les tests pilotés par les données, consultez Overview of Data-Driven Unit Tests.

Pour plus d'informations sur l'utilisation d'attributs, consultez Extension des métadonnées à l'aide des attributs.

Exemples

Le code suivant contient la classe et la méthode à tester.

using System;

namespace BankAccountNS
{
    public class BankAccount
    {
        private string custName;
        private double bal;

        public BankAccount(string customerName, double balance)
        {
            custName = customerName;
            bal = balance;
        }

        public double Balance
        { get { return bal; } }

        public void Debit(double amount)
        {
            if (amount < 0)
                throw new ArgumentOutOfRangeException("amount");
            bal -= amount;
        }
    }
}

Imports System

Namespace BankAccountNS
    Public Class BankAccount
        Private customerName As String
        Private bal As Double

        Public Sub New(ByVal customerName2 As String, ByVal balance As Double)
            customerName = customerName2
            bal = balance
        End Sub

        Public ReadOnly Property Balance() As Double
            Get
                Return bal
            End Get
        End Property

        Public Sub Debit(ByVal amount As Double)
            If amount < 0 Then
                Throw New ArgumentOutOfRangeException("amount")
            End If
            bal -= amount
        End Sub
    End Class
End Namespace

Le test suivant réussit. Il utilise la base de données Access sample.mdb qui contient les données suivantes dans Table1.

Nom	Solde	Montant
Jorg Bott	100	25
Pedro Ruivo	70	60
Mandar Samant	75	71.25
Russell King	159	158
Jun Cao	11.99	11.22

Notez que DataAccessMethod est séquentiel.

using Microsoft.VisualStudio.TestTools.UnitTesting;
using BankAccountNS;
using System;

namespace MyCSTestProject
{
    [TestClass()]
    public class BankAccountTest
    {
        private TestContext testContextInstance;
        public TestContext TestContext
        {
            get { return testContextInstance; }
            set { testContextInstance = value; }
        }

        [TestMethod()]
        [DataSource("System.Data.OleDb",
           "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=\"C:\\sample.mdb\"",
           "Table1",
           DataAccessMethod.Sequential)]
        public void DebitTest()
        {
            string customerName = testContextInstance.DataRow["Name"].ToString();

            double bal = Convert.ToDouble(testContextInstance.DataRow["Balance"]);
            double amt = Convert.ToDouble(testContextInstance.DataRow["Amount"]);

            double newBalance = bal - amt;

            BankAccount target = new BankAccount(customerName, bal);
            target.Debit(amt);

            Assert.AreEqual(newBalance, target.Balance, .00);
        }
    }
}

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports BankAccountNS
Imports System

Namespace TestProject1
    <TestClass()> _
    Public Class BankAccountTest

        Private testContextInstance As TestContext
        Public Property TestContext() As TestContext
            Get
                Return testContextInstance
            End Get
            Set(ByVal Value As TestContext)
                testContextInstance = Value
            End Set
        End Property

        <TestMethod()> _
        <DataSource("System.Data.OleDb", _
        "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=""D:\sample.mdb""", _
        "Table1", DataAccessMethod.Sequential)> _
        Public Sub DebitTest()
            Dim customerName As String = testContextInstance.DataRow("Name").ToString()

            Dim balance As Double = Convert.ToDouble(testContextInstance.DataRow("Balance"))
            Dim amount As Double = Convert.ToDouble(testContextInstance.DataRow("Amount"))

            Dim NewBalance As Double = balance - amount

            Dim target As BankAccount = New BankAccount(customerName, balance)
            target.Debit(amount)

            Assert.AreEqual(NewBalance, target.Balance, 0.0)
        End Sub
    End Class
End Namespace

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.