// --- (end of YVSource implementation) // --- (VSource functions) /** * <summary> * Retrieves a voltage source for a given identifier. * <para> * The identifier can be specified using several formats: * </para> * <para> * </para> * <para> * - FunctionLogicalName * </para> * <para> * - ModuleSerialNumber.FunctionIdentifier * </para> * <para> * - ModuleSerialNumber.FunctionLogicalName * </para> * <para> * - ModuleLogicalName.FunctionIdentifier * </para> * <para> * - ModuleLogicalName.FunctionLogicalName * </para> * <para> * </para> * <para> * This function does not require that the voltage source is online at the time * it is invoked. The returned object is nevertheless valid. * Use the method <c>YVSource.isOnline()</c> to test if the voltage source is * indeed online at a given time. In case of ambiguity when looking for * a voltage source by logical name, no error is notified: the first instance * found is returned. The search is performed first by hardware name, * then by logical name. * </para> * </summary> * <param name="func"> * a string that uniquely characterizes the voltage source * </param> * <returns> * a <c>YVSource</c> object allowing you to drive the voltage source. * </returns> */ public static YVSource FindVSource(string func) { YVSource res; if (_VSourceCache.ContainsKey(func)) { return((YVSource)_VSourceCache[func]); } res = new YVSource(func); _VSourceCache.Add(func, res); return(res); }
// --- (end of YVSource implementation) // --- (VSource functions) /** * <summary> * Retrieves a voltage source for a given identifier. * <para> * The identifier can be specified using several formats: * </para> * <para> * </para> * <para> * - FunctionLogicalName * </para> * <para> * - ModuleSerialNumber.FunctionIdentifier * </para> * <para> * - ModuleSerialNumber.FunctionLogicalName * </para> * <para> * - ModuleLogicalName.FunctionIdentifier * </para> * <para> * - ModuleLogicalName.FunctionLogicalName * </para> * <para> * </para> * <para> * This function does not require that the voltage source is online at the time * it is invoked. The returned object is nevertheless valid. * Use the method <c>YVSource.isOnline()</c> to test if the voltage source is * indeed online at a given time. In case of ambiguity when looking for * a voltage source by logical name, no error is notified: the first instance * found is returned. The search is performed first by hardware name, * then by logical name. * </para> * </summary> * <param name="func"> * a string that uniquely characterizes the voltage source * </param> * <returns> * a <c>YVSource</c> object allowing you to drive the voltage source. * </returns> */ public static YVSource FindVSource(string func) { YVSource res; if (_VSourceCache.ContainsKey(func)) return (YVSource)_VSourceCache[func]; res = new YVSource(func); _VSourceCache.Add(func, res); return res; }