Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Interfaz ISite

 

Publicado: octubre de 2016

Proporciona la funcionalidad necesaria para los sitios.

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

[ComVisibleAttribute(true)]
public interface ISite : IServiceProvider

NombreDescripción
System_CAPS_pubpropertyComponent

Obtiene el componente asociado a la ISite cuando se implementa mediante una clase.

System_CAPS_pubpropertyContainer

Obtiene el IContainer asociado a la ISite cuando se implementa mediante una clase.

System_CAPS_pubpropertyDesignMode

Determina si el componente está en modo de diseño cuando se implementa mediante una clase.

System_CAPS_pubpropertyName

Obtiene o establece el nombre del componente asociado a la ISite cuando se implementa mediante una clase.

NombreDescripción
System_CAPS_pubmethodGetService(Type)

Obtiene el objeto de servicio del tipo especificado.(Heredado de IServiceProvider).

Sites bind a T:System.ComponentModel.Component to a T:System.ComponentModel.Container and enable communication between them, as well as provide a way for the container to manage its components.

Sites can also serve as a repository for container-specific, per-component information, such as the component name. For more information about components, see Programming with Components.

Notas para implementadores:

To be a site, a class must implement the T:System.ComponentModel.ISite interface.

The following example demonstrates the implementation of T:System.ComponentModel.ISite, T:System.ComponentModel.IComponent, and T:System.ComponentModel.IContainer for use in a library container.

/// <summary>
/// The following example demonstrates the implementation of 
/// ISite, IComponent, and IContainer for use in a simple library container.
///
/// This example uses the System, System.ComponentModel, and System.Collections
/// namespaces.
/// </summary>

//This code segment implements the ISite and IComponent interfaces.
//The implementation of the IContainer interface can be seen in the documentation 
//of IContainer.

//Implement the ISite interface.

// The ISBNSite class represents the ISBN name of the book component
class ISBNSite : ISite
{
	private IComponent m_curComponent;
	private IContainer m_curContainer;
	private bool m_bDesignMode;
	private string m_ISBNCmpName;

	public ISBNSite(IContainer actvCntr, IComponent prntCmpnt)
	{
		m_curComponent = prntCmpnt;
		m_curContainer = actvCntr;
		m_bDesignMode = false;
		m_ISBNCmpName = null;
	}

	//Support the ISite interface.
	public virtual IComponent Component
	{
		get
		{
			return m_curComponent;
		}
	}

	public virtual IContainer Container
	{
		get
		{
			return m_curContainer;
		}
	}

	public virtual bool DesignMode
	{
		get
		{
			return m_bDesignMode;
		}
	}

	public virtual string Name
	{
		get
		{
			return m_ISBNCmpName;
		}

		set
		{
			m_ISBNCmpName = value;
		}
	}

	//Support the IServiceProvider interface.
	public virtual object GetService(Type serviceType)
	{
		//This example does not use any service object.
		return null;
	}

}

// The BookComponent class represents the book component of the library container.

// This class implements the IComponent interface.

class BookComponent : IComponent
{
	public event EventHandler Disposed;
	private ISite m_curISBNSite;
	private string m_bookTitle;
	private string m_bookAuthor;

	public BookComponent(string Title, string Author)
	{
		m_curISBNSite = null;
		Disposed = null;
		m_bookTitle = Title;
		m_bookAuthor = Author;
	}

	public string Title
	{
		get
		{
			return m_bookTitle;
		}
	}

	public string Author
	{
		get
		{
			return m_bookAuthor;
		}
	}

	public virtual void Dispose()
	{	
		//There is nothing to clean.
		if(Disposed != null)
			Disposed(this,EventArgs.Empty);
	}

	public virtual ISite Site
	{
		get
		{
			return m_curISBNSite;
		}
		set
		{
			m_curISBNSite = value;
		}
	}

	public override bool Equals(object cmp)
	{
		BookComponent cmpObj = (BookComponent)cmp;
		if(this.Title.Equals(cmpObj.Title) && this.Author.Equals(cmpObj.Author))
			return true;

		return false;
	}

	public override int GetHashCode()
	{
		return base.GetHashCode();
	}
}

.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: