Condividi tramite

Classe PosCommon (documentazione POS per .NET v1.14 SDK)

PosCommon è la classe Base per tutte le classi Interface specifiche e tutti gli oggetti servizio derivano indirettamente da essa. PosCommon definisce le proprietà, i metodi e gli eventi comuni richiesti dalla specifica Unified Point Of Service (UnifiedPOS) in tutte le classi di dispositivi.

Proprietà PosCommon

Nella tabella seguente vengono descritte le proprietà della classe PosCommon disponibili per le applicazioni POS.

Proprietà Type Descrizione
CapCompareFirmwareVersion bool Indica se l'oggetto servizio e il dispositivo supportano il confronto tra la versione del firmware nel dispositivo fisico e quella di un file del firmware.
CapPowerReporting Enumerazione PowerReporting Indica le funzionalità di segnalazione di alimentazione del dispositivo.
CapStatisticsReporting bool Indica se il dispositivo può accumulare e fornire varie statistiche relative all'utilizzo.
CapUpdateStatistics bool Se impostata su true, alcune o tutte le statistiche del dispositivo possono essere reimpostate su 0 (zero) usando il metodo ResetStatistic per un solo aggiornamento e ResetStatistics per un elenco di aggiornamenti, oppure aggiornata usando il metodo UpdateStatistic per un aggiornamento e il metodo UpdateStatistics per un elenco di aggiornamenti con i valori specificati corrispondenti.
CapUpdateFirmware bool Indica se il firmware del dispositivo può essere aggiornato tramite il metodo UpdateFirmware.
CheckHealthText string Indica l'integrità del dispositivo.
Claimed bool Indica se il dispositivo è richiesto per l'accesso esclusivo.
DeviceDescription string Contiene una stringa che identifica il dispositivo e l'azienda che lo ha prodotto.
DeviceEnabled bool Indica se il dispositivo è in uno stato operativo.
DeviceName string UnifiedPOS lo chiama PhysicalDeviceName; OLE for Retail POS (OPOS) lo chiama DeviceName.
DevicePath string Impostato da POS per .NET per i dispositivi Plug and Play. Per i dispositivi non Plug and Play, DevicePath può essere assegnato usando un file di configurazione.
FreezeEvents bool Se impostata su true, l'applicazione ha richiesto che l'oggetto servizio non fornisca eventi.
PowerNotify Enumerazione PowerNotification Contiene il tipo di selezione della notifica di alimentazione effettuata dall'applicazione.
PowerState Enumerazione PowerState Contiene la condizione di alimentazione corrente.
ServiceObjectDescription string Identifica l'oggetto servizio che supporta il dispositivo e l'azienda che lo ha prodotto. Questa proprietà è elencata come DeviceServiceDescription nella specifica UnifiedPOS.
ServiceObjectVersion System.Version Contiene il numero di versione dell'oggetto servizio. Questa proprietà è elencata come DeviceServiceVersion nella specifica UnifiedPOS.
Provincia Enumerazione ControlState Mantiene lo stato corrente del dispositivo.
SynchronizingObject ISynchronizeInvoke Ottiene o imposta l'oggetto di marshalling per le chiamate del gestore eventi da un evento POS.

Metodi PosCommon

Nella tabella seguente vengono descritti i metodi della classe PosCommon disponibile per le applicazioni.

metodo Tipo restituito Descrizione
CheckHealth string Esegue un controllo di integrità nel dispositivo. Il tipo di controllo da eseguire è indicato dal parametro HealthCheckLevel. Il metodo aggiorna anche la proprietà CheckHealthText.
Richiesta di rimborso void Richiede l'accesso esclusivo al dispositivo. Gli autori di oggetti servizio sono invitati a generare solo eccezioni in condizioni impreviste, ad esempio OutOfMemory. In caso contrario, gli oggetti servizio devono restituire True se il dispositivo è stato richiesto e False se si è verificato un timeout.
Chiusura void Rilascia il dispositivo e le relative risorse.
CompareFirmwareVersion CompareFirmwareResult Determina se la versione del firmware specificato è più recente di, precedente o uguale alla versione del firmware nel dispositivo fisico.
DirectIO DirectIOData Utilizzato per comunicare direttamente con l'oggetto servizio. Nella specifica UnifiedPOS sono presenti due parametri in/out. Come usato da POS per .NET, questo metodo restituisce una struttura e nessun parametro in/out.
Apertura void Apre un dispositivo per l'elaborazione di input/output successiva.
Versione void Rilascia l'accesso esclusivo al dispositivo.
ResetStatistic void Reimposta la statistica specificata su zero. Usato in POS per .NET per le operazioni su una singola statistica.
ResetStatistics void Reimposta tutte le statistiche per una categoria specificata su 0 (zero).
ResetStatistics void Reimposta le statistiche specificate su 0 (zero).
ResetStatistics void Reimposta tutte le statistiche associate a un dispositivo su 0 (zero).
RetrieveStatistic string Recupera la statistica del dispositivo specificata. Usato in POS per .NET per le operazioni su una singola statistica.
RetrieveStatistics string Recupera tutte le statistiche del dispositivo.
RetrieveStatistics void Recupera le statistiche per la categoria specificata.
RetrieveStatistics void Recupera le statistiche specificate.
UpdateFirmware void Aggiorna il firmware di un dispositivo con la versione del firmware contenuta nel nome file specificato.
UpdateStatistic void Aggiorna una statistica. Aggiunta a POS per .NET per le operazioni su una singola statistica.
UpdateStatistics void Aggiornai un elenco di statistiche con i valori specificati corrispondenti.
UpdateStatistics void Aggiorna la categoria specificata di statistiche con il valore specificato.

Eventi PosCommon

Nella tabella seguente vengono descritti gli eventi della classe PosCommon.

metodo Descrizione
DirectIOEvent Generato dall'oggetto servizio per comunicare le informazioni direttamente all'applicazione.
StatusUpdateEvent Generato dall'oggetto servizio per avvisare l'applicazione di una modifica dello stato di un dispositivo.

Esempio

Nell'esempio di codice seguente viene illustrato come usare le proprietà e i metodi comuni a tutti gli oggetti servizio per visualizzare informazioni su un dispositivo connesso.

// Create a derived class of PosCommon
public class PosCommonSample: PosCommon
{
    // Implement all base methods and properties.
    // ...
}

// Create instances for the example.
PosExplorer explorer = new PosExplorer();
PosCommonSample pcs = new PosCommonSample();
DeviceInfo device = explorer.GetDevice("MSR");
pcs = (PosCommonSample)explorer.CreateInstance(device);

// Open and claim the device, then print information
// about the device to the console.
pcs.Open();
pcs.Claim(1000);
Console.WriteLine("Name: {0}", pcs.DeviceName);
Console.WriteLine("Description: {0}", pcs.DeviceDescription);
Console.WriteLine("Path: {0}", pcs.DevicePath);
Console.WriteLine("Enabled: {0}", pcs.DeviceEnabled);

pcs.Close();

Vedi anche

Concetti

  • Last updated on