Make your own free website on Tripod.com

Сумма прописью
(.NET-компонент)

English version

Версия для WSH

SmartTag-версия


.NET-компонент (и Web-сервис) для перевода чисел в словесное представление ("сумма прописью")

Производит конвертацию чисел и простых выражений в словесное представление. Обрабатываются числа длиной до 15 цифр (999 триллионов), словесное представление формируется для трёх валют (рубль, доллар, евро) на русском и английском языках.

УСТАНОВКА:

  • компонент функционирует на компьютерах с Windows 2000 (на других версиях не испытывался)
  • необходимо установить последнюю версию Microsoft.NET Framework (не ниже 1.0)
  • необходимо установить последнюю версию Windows Scripting Host (не ниже 5.5) - для выполнения примера.
  • файлы из архива поместите в любой каталог (который не будете в ближайшее время удалять) и зарегистрируйте сборку (assembly)  в системе при помощи командного файла register.bat

СВОЙСТВА И МЕТОДЫ:

  • About - Строка с кратким описанием компонента.
  • ValutaId - Идентификатор валюты (можно задать "R" для рублей, "$" для долларов, "E" для евро).
  • Language - Идентификатор языка словесного представления (можно задать "ru"/1049 для русского, "en"/1033 для английского).
  • CheckExpression - Пытаться вычислить выражение в Source (логическое).[пока не работает!!!]
  • CutOffZero - Не формировать представление нулевых значений копеек/центов.
  • OddMoneyInWords - Мелочь (копейки/центы) словами (логическое).
  • Source - Исходное значение (число или строка) для конвертации в словесное представление.
  • Result(string) - Результат конвертации string (свойство по умолчанию).
  • Convert(string) - Выполнить конвертацию строки string, вернуть результат конвертации.
  • Execute() - Выполнить конвертацию значения из Source, результат поместить в Result.
  • SetDefault() - Зафиксировать текущие значения параметров (ValutaId, Language, CheckExpression, CutOffZero, OddMoneyInWords) в качестве значений "по умолчанию"
  • RubInWords(num) - Число в рубли.
  • UsdInWords(num) - Число в доллары.
  • EurInWords(num) - Число в евро.

ИСПОЛЬЗОВАНИЕ.

Свойства и методы компонента могут быть использованы:

  •  в любой программе для среды .NET (подключить пространство имён DkmS.Money.Intl.NET)
  • в XML Web-сервисах (подключить пространство имён DkmS.Money.Intl.NET)
  •  в программах, способных выступать в качестве клиента OLE-автоматизации - VB, VC, WSH, компоненты MS Office, Delphi и др. (использовать библиотеку типов InWordsIntl_NET.tlb).

Примеры:

  • test.exe - тестовая программа для среды .NET (исходный текст - в файле test.vb. При компиляции используйте ключ /r:Num2Words.dll).
  • Файл num2word_ws.zip - пример использования компонента в Web-сервисе (инструкция по использованию - в файле Conv.net.ws.read.me.ru внутри архива).
  • Файл conv_test.vbs - примеры использования конвертера в WSH. Для запуска использовать команду

    cscript.exe conv_test.vbs
     
  • Файл conv_net_test.xls содержит функции (ToUSD, ToRUR, ToEUR), которые можно использовать для получения словесного представления на английском и русском языках чисел из ячеек таблицы. При открытии файла в MS Excel следует разрешить макросы.

Замечания:

  • Во время первого использования конвертер устанавливает собственные параметры "по умолчанию" в соответствии с системными настройками. Для изменения умолчаний используйте метод SetDefault. Пример использования метода см. в файле conv_test.vbs.
  • Перед использованием метода Convert свойству ValutaId можно присвоить значение "" (пустая строка) или "??". Метод в этом случае попытается выделить название денежной единицы в переданной строке string.

Возможности по модификации программы:

Программа написана на языке VB.NET, поставляется с исходным кодом. Для модификации программы требуется лишь простейший текстовый редактор, компилятор входит в состав .NET Framework SDK.
Вы можете вносить в код любые изменения (если получится что-нибудь полезное, сообщите).

 % Загрузка архива с программой: site-1.