Freigeben über


IHostedTest-Schnittstelle

Ein Testtyp, der die IHostedTest-Schnittstelle implementiert oder von einer Klasse erbt, die die IHostedTest-Schnittstelle implementiert, kann von einem Hostadapter gehostet werden. Benutzerdefinierte Testtypen werden normalerweise von der TestElement-Klasse abgeleitet, und die TestElement-Klasse implementiert die IHostedTest-Schnittstelle. Infolgedessen kann jeder Testtyp, der sich von TestElement ableitet, von einem Hostadapter gehostet werden.

Namespace:  Microsoft.VisualStudio.TestTools.Common
Assembly:  Microsoft.VisualStudio.QualityTools.Common (in Microsoft.VisualStudio.QualityTools.Common.dll)

Syntax

'Declaration
Public Interface IHostedTest
public interface IHostedTest
public interface class IHostedTest
type IHostedTest =  interface end
public interface IHostedTest

Der IHostedTest-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft HostType Die IHostedTest.HostType-Zeichenfolge identifiziert einen Host.Tester können diese Zeichenfolge bei einem benutzerdefinierten Test im HostType-Attribut verwenden, um einen Host anzugeben, auf dem der Test ausgeführt werden soll.

Zum Seitenanfang

Hinweise

Wenn sich der benutzerdefinierte Testtyp nicht von TestElement ableitet, können die Tests von einem Hostadapter gehostet werden, wenn Sie einen der folgenden Schritte beachten:

  • Codieren Sie den Testtyp so, dass IHostedTest implementiert wird.

  • Codieren Sie den Testtyp nicht so, dass er IHostedTest implementiert. In diesem Fall kann der Testtyp immer noch gehostet werden, wenn Sie Hostingregeln in der Registrierung konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Host-Adapter und Test-Typen.

Das Eigenschaftenfenster verfügt über zwei Eigenschaften, die von TestElement bereitgestellt werden: Hosttyp und Hostdaten. Diese Eigenschaften sind für jeden Testtyp verfügbar, der sich von TestElement ableitet.

Beispiele

Den vollständigen Code für das folgende Beispiel finden Sie in der Datei MyTest.cs im Testerweiterbarkeitsbeispiel im Visual Studio-SDK.

using Microsoft.VisualStudio.TestTools.Common;
using Microsoft.VisualStudio.TestTools.Vsip;

class MyTest : TestElement 
{
    // TestElement - specific members.
    // ...

    // Copy constructor: copy m_hostType.
    public MyTest(MyTest copy)
        : base(copy)
    {
        // TestElement - specific data.
        // …

        m_hostType = copy.m_hostType;
    }

    // ITestElement.Clone is required by test case management.
    // Call copy constructor which copies m_hostType, 
    // so that cloned test has the same m_hostType as original test.
    public override object Clone()
    {
        return new MyTest(this);
    }

    // Persisted host type associated with the test.
    [PersistenceElementName("HostType")]
    private string m_hostType;
}

Siehe auch

Referenz

Microsoft.VisualStudio.TestTools.Common-Namespace

Weitere Ressourcen

Konfigurieren von Host-Adapter und Test-Typen