DataSourceAttribute – třída

Článek
05/14/2013

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

Hierarchie dědičnosti

System.Object
System.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)	Vytvoří novou instanci třídy DataSourceAttribute.Tato instance bude inicializován s dat zprostředkovatele a připojovací řetězec přidružený název nastavení.
	DataSourceAttribute(String, String)	Vytvoří novou instanci třídy DataSourceAttribute.Tato instance bude inicializován s názvem připojení řetězec a tabulky.
	DataSourceAttribute(String, String, String, DataAccessMethod)	Vytvoří novou instanci třídy DataSourceAttribute.Tato instance bude inicializován pomocí zprostředkovatele dat, připojovací řetězec, tabulku dat a metoda přístupu dat pro přístup ke zdroji dat.

Nahoru

Vlastnosti

	Název	Popis
	ConnectionString	Získá hodnotu představující připojovací řetězec zdroje dat.
	DataAccessMethod	Získá metodu pro přístup ke zdroji dat.
	DataSourceSettingName	Získá hodnotu určující název nastavení identifikovat informace o připojení zdroje dat uloženy v konfiguračním souboru.
	ProviderInvariantName	Získá hodnotu představující zprostředkovatele dat ze zdroje dat.
	TableName	Získá hodnotu určující název tabulky, který poskytuje data.
	TypeId	Po implementaci v odvozené třídě, získá tento jedinečný identifikátor Attribute. (Zděděno z Attribute.)

Nahoru

Metody

	Název	Popis
	Equals	Infrastruktura. Vrátí hodnotu, která označuje, zda je tato instance rovna zadaný objekt. (Zděděno z Attribute.)
	GetHashCode	Vrátí kód hash pro tuto instanci. (Zděděno z Attribute.)
	GetType	Získá Type aktuální instance. (Zděděno z Object.)
	IsDefaultAttribute	Přepsat v odvozené třídě, označuje, zda je hodnota této instanci výchozí hodnotu 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	Představuje metodu výchozí data aplikace access.Toto pole je jen pro čtení.
	DefaultProviderName	Představuje výchozí název zprostředkovatele dat.Toto pole je jen pro čtení.

Nahoru

Explicitní implementace rozhraní

	Název	Popis
	_Attribute.GetIDsOfNames	Mapuje sadu názvů odpovídající sadu identifikátorů odeslání. (Zděděno z Attribute.)
	_Attribute.GetTypeInfo	Načte informace o typu objektu, který lze získat informace o rozhraní typu. (Zděděno z Attribute.)
	_Attribute.GetTypeInfoCount	Vyhledá číslo rozhraní typu informace, že objekt obsahuje (0 nebo 1). (Zděděno z Attribute.)
	_Attribute.Invoke	Poskytuje přístup k vlastnostem a metodám prostřednictvím objektu. (Zděděno z Attribute.)

Nahoru

Poznámky

DataSourceAttribute Třída poskytuje dva způsoby zadání dat zdroje informací pro datově řízené testy.Prvním způsobem určuje informace pomocí připojovacího řetězce poskytovatele informace a předán název zdrojové tabulky 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ává atribut, který určuje nastavení konfigurace, které jsou umístěny v jeden argument app.config souboru.

Příklad nastavení konfigurace:

[DataSource("dataSourceNameFromConfigFile")]

[!POZNÁMKA]

Poskytovatelů různých dat pomocí různých 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ázorný postup: Definovat zdroj dat pomocí konfiguračního souboru.

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

Další informace o použití atributů naleznete v Rozšíření 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á.Sample.mdb přístup k databázi, která obsahuje následující data v Tabulka1 používá.

Název	Zůstatek	Částka
Jorg Bott	100	25
Pedro Ruivo	70	60
Mandar Samant	75	71.25
Král Rostislav	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.