DataSourceAttribute – třída

Článek
05/16/2015

Obsahuje informace specifické pro zdroj dat pro datové testování.Tato třída nemůže být zděděna.

Hierarchie dědičnosti

Object
Attribute
Microsoft.VisualStudio.TestTools.UnitTesting.DataSourceAttribute

Obor názvů: Microsoft.VisualStudio.TestTools.UnitTesting
Sestavení: Microsoft.VisualStudio.QualityTools.UnitTestFramework (v Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

Syntaxe

'Deklarace
<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

Typ DataSourceAttribute zveřejňuje následující členy.

Konstruktory

	Název	Popis
	DataSourceAttribute(String)	Inicializuje novou instanci třídy DataSourceAttribute. Tato instance bude inicializován pomocí dat zprostředkovatele a připojovací řetězec přidružený název nastavení.
	DataSourceAttribute(String, String)	Inicializuje novou instanci třídy DataSourceAttribute.Tato instance bude inicializován s název připojovacího řetězce a tabulky.
	DataSourceAttribute(String, String, String, DataAccessMethod)	Inicializuje novou instanci třídy DataSourceAttribute. Tato instance bude inicializován pomocí zprostředkovatele dat, připojovací řetězec, tabulky dat a metoda přístupu dat pro přístup ke zdroji dat.

Nahoru

Vlastnosti

	Název	Popis
	ConnectionString	Získá hodnotu reprezentující spojovací řetězec pro zdroj dat.
	DataAccessMethod	Metoda používaná pro přístup k zdroj dat získává.
	DataSourceSettingName	Získá hodnotu označující nastavení název sloužící k identifikaci zdroje informace o připojení uloženo v konfiguračním souboru.
	ProviderInvariantName	Získá hodnotu reprezentující poskytovatel dat pro zdroj dat.
	TableName	Získá hodnotu označující název tabulky poskytující data.
	TypeId	Po implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno z Attribute.)

Nahoru

Metody

	Název	Popis
	Equals	Infrastruktura. Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno z Attribute.)
	GetHashCode	Vrátí kód hash této instance. (Zděděno z Attribute.)
	GetType	Získá Type aktuální instance. (Zděděno z Object.)
	IsDefaultAttribute	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnota pro odvozené třídy. (Zděděno z Attribute.)
	Match	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda tato instance se rovná zadaný objekt. (Zděděno z Attribute.)
	ToString	Vrátí řetězec, který představuje aktuální objekt. (Zděděno z Object.)

Nahoru

Pole

	Název	Popis
	DefaultDataAccessMethod	Výchozí metoda přístupu dat představuje.Toto pole je jen pro čtení.
	DefaultProviderName	Představuje výchozí název zprostředkovatele.Toto pole je jen pro čtení.

Nahoru

Explicitní implementace rozhraní

	Název	Popis
	System#Runtime#InteropServices#_Attribute#GetIDsOfNames	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno z Attribute.)
	System#Runtime#InteropServices#_Attribute#GetTypeInfo	Načte informace o typu objektu, který lze použít, chcete-li získat informace o typu rozhraní. (Zděděno z Attribute.)
	System#Runtime#InteropServices#_Attribute#GetTypeInfoCount	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno z Attribute.)
	System#Runtime#InteropServices#_Attribute#Invoke	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno z Attribute.)

Nahoru

Poznámky

DataSourceAttribute Třída poskytuje dva způsoby, jak určit data zdroje informací pro datově řízené testy. Prvním způsobem určuje informace prostřednictvím připojovací řetězec informace zprostředkovatele a název zdrojové tabulky předány DataSourceAttribute.

Příklad řetězce připojení:

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

Druhým způsobem předá atribut, který určuje nastavení konfigurace, které jsou umístěny v jediný argument app.config souboru.

Příklad nastavení konfigurace:

[DataSource("dataSourceNameFromConfigFile")]

[!POZNÁMKA]

Poskytovatelé různých dat používají různé připojovací řetězce.Název zprostředkovatele je součástí řetězce připojení.

Další informace o použití app.config soubor pro určení zdroje dat, viz Návod: Použití konfiguračního souboru k definování zdroje dat.

Další informace o datové zkoušky viz Data-Driven Unit Tests.

Další informace o použití atributů naleznete v tématu Rozšiřování metadat pomocí atributů.

Příklady

Následující kód obsahuje třídy a metody testování.

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

Následující test předá.Používá databázi sample.mdb obsahuje následující data do tabulky Tabulka1.

Název	Zůstatek	Částka
Jorg Bott	100	25
Pedro Ruivo	70	60
Mandar Samant	75	71.25
Rostislav král	159	158
JUN Cao	11.99	11.22

Všimněte si, že DataAccessMethod je sekvenční.

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

Bezpečný přístup z více vláken

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.